Función TLSLicenseEnumBegin

Artículo
06/13/2023

Comienza la enumeración de licencias emitidas por el servidor de licencias de Escritorio remoto en función de 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 TLSLicenseEnumBegin(
  _In_  TLS_HANDLE hHandle,
  _In_  DWORD      dwSearchParm,
  _In_  BOOL       bMatchAll,
  _In_  LSLicense  *lpSearchParm,
  _Out_ PDWORD     pdwErrCode
);

Parámetros

hHandle [in]: Controle a un servidor de licencias de Escritorio remoto. Especifique un identificador abierto por la función TLSConnectToLsServer .
dwSearchParm [in]: Especifica los criterios de búsqueda. El parámetro puede ser una o una combinación de los valores que se describen en la lista siguiente. El parámetro especifica el tipo de paquete de claves y qué paquete de claves se va a buscar.
LSLICENSE_SEARCH_LICENSEID (0x00000001): Busque por identificador de licencia.
LSLICENSE_SEARCH_KEYPACKID (0x00000002): Busque por identificador de paquete de claves.
LSLICENSE_SEARCH_MACHINENAME (0x00000008): Busque por nombre de máquina.
LSLICENSE_SEARCH_USERNAME (0x00000010): Busque por nombre de usuario.
LSLICENSE_SEARCH_ISSUEDATE (0x00000080): Buscar por fecha de problema.
LSLICENSE_SEARCH_EXPIREDATE (0x00000100): Buscar por fecha de expiración.
LSLICENSE_SEARCH_ NUMLICENSES (0x00000200): Busque por número de licencias.
LSLICENSE_SEARCH_ ENTRY_STATUS (0x20000000): Buscar por estado de entrada.
LSLICENSE_EXSEARCH_LICENSESTATUS (0x00100000): Busque por estado de licencia.
LSKEYPACK_SEARCH_ALL (0xFFFFFFFF): Buscar todas las licencias.

bMatchAll [in]

Especifica si se deben coincidir todos los valores de búsqueda.

lpSearchParm [in]

Puntero a una estructura LSLicense que especifica los parámetros de búsqueda que se van a buscar.

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_E_INTERNAL_ERROR (5001)

Error interno en el servidor de licencias.

LSERVER_E_INVALID_SEQUENCE (5006)

La secuencia de llamada no era válida. Lo más probable es que una enumeración anterior no haya finalizado.

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.

LSERVER_E_INVALID_DATA (5009)

Los datos del parámetro de búsqueda no son válidos.

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
TLSLicenseEnumNext
TLSLicenseEnumEnd