rsp

Documentation

Overview

The rsp package implements the RSP client protocol.

Introduction

This document specifies the Remote Shutdown Protocol. The Remote Shutdown Protocol is a remote procedure call (RPC)-based protocol used to shut down or terminate shutdown on a remote computer.

Overview

The Remote Shutdown Protocol is designed for shutting down a remote computer or for terminating the shutdown of a remote computer during the shutdown waiting period. Following are some of the examples of this protocol's applications:

* Shut down a remote computer and display a message in the shutdown dialog box for 30 seconds.

* Terminate a requested remote system shutdown during the shutdown waiting period.

* Force applications to be closed, log off users, and shut down a remote computer.

* Reboot a remote computer.

In this document, the use of the terms client and server are in the protocol client and server context. This means that the client will initiate an RPC call and the server will respond.

This is an RPC-based protocol. The protocol operation is stateless.

This is a simple request-response protocol. For every method that the server receives, it executes the method and returns a completion. The client simply returns the completion status to the caller. This is a stateless protocol; each method call is independent of any previous method calls.

Index

• Variables
• type UnicodeString
  • func (o *UnicodeString) MarshalNDR(ctx context.Context, w ndr.Writer) error
  • func (o *UnicodeString) UnmarshalNDR(ctx context.Context, w ndr.Reader) error

Variables

var (
	// import guard
	GoPackage = "rsp"
)

Types

type UnicodeString

type UnicodeString struct {
	// Length:  The number of bytes actually used by the string. Because all UTF-16 characters
	// occupy 2 bytes, this MUST be an even number in the range [0...65534]. The behavior
	// for odd values is unspecified.
	Length uint16 `idl:"name:Length" json:"length"`
	// MaximumLength:  The number of bytes allocated for the string. This MUST be an even
	// number in the range [Length...65534].
	MaximumLength uint16 `idl:"name:MaximumLength" json:"maximum_length"`
	// Buffer:  The Unicode UTF-16 characters comprising the string described by the structure.
	// Note that counted strings might be terminated by a 0x0000 character, by convention;
	// if such a terminator is present, it SHOULD NOT count toward the Length (but MUST,
	// of course, be included in the MaximumLength).
	Buffer []uint16 `idl:"name:Buffer;size_is:((MaximumLength/2));length_is:((Length/2))" json:"buffer"`
}

UnicodeString structure represents REG_UNICODE_STRING RPC structure.

This REG_UNICODE_STRING structure represents a counted string of Unicode (UTF-16) characters.

func (*UnicodeString) MarshalNDR

func (o *UnicodeString) MarshalNDR(ctx context.Context, w ndr.Writer) error

func (*UnicodeString) UnmarshalNDR

func (o *UnicodeString) UnmarshalNDR(ctx context.Context, w ndr.Reader) error