Función TLSKeyPackEnumBegin

Artículo
06/13/2023

Comienza la enumeración a través de todos los paquetes de claves que se instalan en un 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 TLSKeyPackEnumBegin(
  _In_  TLS_HANDLE hHandle,
  _In_  DWORD      dwSearchParm,
  _In_  BOOL       bMatchAll,
  _In_  LSKeyPack  *lpSearchParm,
  _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 .
dwSearchParm [in]: Especifica los criterios de búsqueda. Este parámetro está reservado para uso futuro y debe contener 0xFFFFFFFF.
bMatchAll [in]: Especifica si se deben coincidir todos los valores de búsqueda.
lpSearchParm [in]: Puntero a una estructura LSKeyPack 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

LSKeyPack
TLSConnectToLsServer
TLSKeyPackEnumNext
TLSKeyPackEnumEnd