IWRdsProtocolLicenseConnection::RequestClientLicense method (wtsprotocol.h)

Requests a license from the client.

Syntax

HRESULT RequestClientLicense(
  [in]      PBYTE Reserve1,
  [in]      ULONG Reserve2,
  [out]     PBYTE ppClientLicense,
  [in, out] ULONG *pcbClientLicense
);

Parameters

[in] Reserve1

A pointer to a byte array that contains additional data that can be acted upon by the client.

[in] Reserve2

An integer that contains the size, in bytes, of the data specified by the Reserve1 parameter.

[out] ppClientLicense

A pointer to a byte array that contains the license request.

[in, out] pcbClientLicense

An integer that contains the size, in bytes, of the request specified by the ppClientLicense parameter.

Return value

When you are implementing this method, return S_OK if the function succeeds. If it fails, return an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Remarks

For more information about the byte arrays exchanged in this call (such as the CLIENT_LICENSE_INFO, CLIENT_NEW_LICENSE_REQUEST, and CLIENT_PLATFORM_CHALLENGE_RESPONSE packet structures), see [MS-RDPELE]: Remote Desktop Protocol: Licensing Extension.

Requirements

See also

IWRdsProtocolLicenseConnection