IWTSProtocolLicenseConnection::RequestClientLicense method (wtsprotocol.h)

[IWTSProtocolLicenseConnection::RequestClientLicense is no longer available for use as of Windows Server 2012. Instead, use IWRdsProtocolLicenseConnection::RequestClientLicense.]

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, see [MS-RDPELE]: Remote Desktop Protocol: Licensing Extension.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008 R2
Target Platform Windows
Header wtsprotocol.h

See also

IWTSProtocolLicenseConnection