3.7.4.1.1 RpcWinStationOpenServer (Opnum 0)

  • Article

The RpcWinStationOpenServer method returns a server handle that can be used in other WinStation API methods for querying information about the WinStation (sessions) on the server. No special permissions are required to call this method.

 BOOLEAN RpcWinStationOpenServer(
   [in] handle_t hBinding,
   [out] DWORD* pResult,
   [out] SERVER_HANDLE* phServer
 );

hBinding: The RPC binding handle.

pResult:  Failure error code if the call to RpcWinStationOpenServer failed. If the call was successful, this parameter is STATUS_SUCCESS (0x00000000) (as specified in [MS-ERREF]).

Value

Meaning

STATUS_SUCCESS

0x00000000

Successful call.

STATUS_CANCELLED

0xC0000120

The server is shutting down.

STATUS_NO_MEMORY

0xC0000017

Not enough memory to complete the operation.

phServer: Handle to the server object. This is of type SERVER_HANDLE. This handle is used by other RpcWinStation methods.

Return Values: Returns TRUE if the call succeeded, or FALSE if the call failed. On failure, pResult indicates the failure status code.

Return value/code

Description

0x01

TRUE

Successful completion.

0x00

FALSE

Method call failed.