Función TLSLicenseEnumNext

Artículo
06/13/2023

Continúa desde una llamada anterior a la función TLSLicenseEnumBegin y devuelve la siguiente licencia instalada en un servidor de licencias de Escritorio remoto que coincida con los criterios de búsqueda.

Nota:

Esta función no tiene ningún archivo de encabezado asociado ni biblioteca de importación. Para llamar a esta función, debe crear un archivo de encabezado definido por el usuario y usar las funciones LoadLibrary y GetProcAddress para vincular dinámicamente a Mstlsapi.dll.

Sintaxis

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

Parámetros

hHandle [in]: Identificador de un servidor de licencias de Escritorio remoto. Especifique un identificador abierto por la función TLSConnectToLsServer .
lpLicense [in]: Puntero a una estructura LSLicense que recibe la siguiente licencia que coincide con los criterios de búsqueda.
pdwErrCode [out]: Puntero a una variable que recibe uno de los siguientes códigos de error al devolver.
LSERVER_S_SUCCESS (0): La llamada se realiza correctamente.
LSERVER_I_NO_MORE_DATA (4001): No hay más licencias que coincidan con los criterios de búsqueda.
LSERVER_E_INTERNAL_ERROR (5001): Error interno en el servidor de licencias.
LSERVER_E_INVALID_SEQUENCE (5006): La secuencia de llamada no era válida. Debe llamar a la función TLSLicenseEnumBegin() antes de esto.
LSERVER_E_SERVER_BUSY (5007): El servidor de licencias está demasiado ocupado para procesar la solicitud.
LSERVER_E_OUTOFMEMORY (5008): No se puede procesar la solicitud debido a memoria insuficiente.

Valor devuelto

Esta función devuelve los siguientes valores devueltos posibles.

RPC_S_OK: La llamada se realizó correctamente. Compruebe el valor del parámetro pdwErrCode para obtener el código de retorno de la llamada.
RPC_S_INVALID_ARG: El argumento no era válido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Archivo DLL	Mstlsapi.dll

Consulte también

LSLicense
TLSConnectToLsServer
TLSLicenseEnumBegin
TLSLicenseEnumEnd

Share via