3.3.4.1.13 RpcGetSessionInformation (Opnum 12)

  • Article

The RpcGetSessionInformation method retrieves information about a specified session running on a terminal server. The caller MUST have WINSTATION_QUERY permission for the session. The method checks whether the caller has WINSTATION_QUERY permission (section 3.1.1) by setting it as the Access Request mask, and fails if the caller does not have the permission. 

 HRESULT RpcGetSessionInformation(
   [in] handle_t hBinding,
   [in] LONG SessionId,
   [ref, out] PLSMSESSIONINFORMATION pSessionInfo
 );

hBinding:  The RPC binding handle. For more information, see [MSDN-RPCBIND].

SessionId:  The identifier of the session whose information is to be retrieved.

pSessionInfo:  A PLSMSESSIONINFORMATION element containing information about the session.

Return Values:  The method MUST return S_OK (0x00000000) on success; otherwise, it MUST return an implementation-specific negative value.

Return value/code

Description

0x00000000

S_OK

Successful completion.