Función TLSKeyPackEnumBegin
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 |
|