TLSLicenseEnumNext function

Continues from a previous call to the TLSLicenseEnumBegin function and returns the next license that is installed on a Remote Desktop license server that matches the search criteria.

Note

This function has no associated header file or import library. To call this function, you must create a user-defined header file and use the LoadLibrary and GetProcAddress functions to dynamically link to Mstlsapi.dll.

Syntax

DWORD WINAPI TLSLicenseEnumNext(
  _In_  TLS_HANDLE hHandle,
  _In_  LSLicense  *lpLicense,
  _Out_ PDWORD     pdwErrCode
);

Parameters

hHandle [in]

Handle to a Remote Desktop license server. Specify a handle that is opened by the TLSConnectToLsServer function.

lpLicense [in]

Pointer to a LSLicense structure that receives the next license that matches the search criteria.

pdwErrCode [out]

Pointer to a variable that receives one of the following error codes on return.

LSERVER_S_SUCCESS (0)

Call is successful.

LSERVER_I_NO_MORE_DATA (4001)

No more licenses match the search criteria.

LSERVER_E_INTERNAL_ERROR (5001)

Internal error in license server.

LSERVER_E_INVALID_SEQUENCE (5006)

The calling sequence was not valid. Must call the TLSLicenseEnumBegin() function before this.

LSERVER_E_SERVER_BUSY (5007)

License server is too busy to process the request.

LSERVER_E_OUTOFMEMORY (5008)

Cannot process the request because of insufficient memory.

Return value

This function returns the following possible return values.

RPC_S_OK

The call succeeded. Check the value of the pdwErrCode parameter to get the return code for the call.

RPC_S_INVALID_ARG

The argument was not valid.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
DLL	Mstlsapi.dll

See also

LSLicense

TLSConnectToLsServer

TLSLicenseEnumBegin

TLSLicenseEnumEnd