3.7.4.1.35 RpcWinStationOpenSessionDirectory (Opnum 75)

  • Article

The RpcWinStationOpenSessionDirectory method pings the Session Directory to see if it can accept RPC calls. The caller MUST be either SYSTEM or an administrator. The method performs access checks as defined in sections 3.1.2 and 3.1.3. The method fails if both checks fail. For more information about the Session Directory, see [MSFT-SDLBTS].<211>

 BOOLEAN RpcWinStationOpenSessionDirectory(
   [in] SERVER_HANDLE hServer,
   [out] DWORD* pResult,
   [in, string, max_is(64)] PWCHAR pszServerName
 );

hServer: Handle to the server object. This is of type SERVER_HANDLE. The hServer argument MUST be obtained from a previous call to RpcWinStationOpenServer.

pResult:  Failure error code if the call to RpcWinStationOpenSessionDirectory failed. If the call was successful, this parameter MUST be STATUS_SUCCESS (0x00000000).

Value

Meaning

STATUS_SUCCESS

0x00000000

The call was successful.

STATUS_UNSUCCESSFUL

0xC0000001

The server is not in application server mode on an advanced servers Stock Keeping Unit (SKU).

STATUS_ACCESS_DENIED

0xC0000022

The caller is not SYSTEM nor an administrator.

pszServerName: The name of the server hosting session directory to which to attempt connection.

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

Return value/code

Description

0x01

TRUE

Successful completion.

0x00

FALSE

Method call failed.