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