3.5.4.1.2 RpcGetConfigData (Opnum 1)

  • Article

The RpcGetConfigData method returns the configuration data associated with the user connected to a particular session running on a terminal server. The caller MUST have WINSTATION_QUERY permission. 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.<156>

 HRESULT RpcGetConfigData(
   [in] handle_t hBinding,
   [in] ULONG SessionId,
   [out, size_is(,*pOutBuffByteLen )] 
     unsigned char** ppBuff,
   [out] ULONG* pOutBuffByteLen
 );

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

SessionId:  The ID of the session for which the client configuration data is to be retrieved.

ppBuff:  The buffer that will contain the client configuration data. This will be allocated by RpcGetConfigData. This data is of type PWINSTATIONCONFIG.

pOutBuffByteLen:  The number of bytes of client configuration data that is returned.

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.