Funzione TLSKeyPackEnumBegin

Articolo
06/13/2023

Avvia l'enumerazione tramite tutti i key pack installati in un server licenze Desktop remoto in base ai criteri di ricerca.

Nota

Questa funzione non ha un file di intestazione o una libreria di importazione associata. Per chiamare questa funzione, è necessario creare un file di intestazione definito dall'utente e usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Mstlsapi.dll.

Sintassi

DWORD WINAPI TLSKeyPackEnumBegin(
  _In_  TLS_HANDLE hHandle,
  _In_  DWORD      dwSearchParm,
  _In_  BOOL       bMatchAll,
  _In_  LSKeyPack  *lpSearchParm,
  _Out_ PDWORD     pdwErrCode
);

Parametri

hHandle [in]: Gestire in un server licenze Desktop remoto. Specificare un handle aperto dalla funzione TLSConnectToLsServer .
dwSearchParm [in]: Specifica i criteri di ricerca. Questo parametro è riservato per uso futuro e deve contenere 0xFFFFFFFF.
bMatchAll [in]: Specifica se trovare la corrispondenza con tutti i valori di ricerca.
lpSearchParm [in]: Puntatore a una struttura LSKeyPack che specifica i parametri di ricerca da cercare.
pdwErrCode [out]: Puntatore a una variabile che riceve uno dei codici di errore seguenti al momento della restituzione.
LSERVER_S_SUCCESS (0): La chiamata ha esito positivo.
LSERVER_E_INTERNAL_ERROR (5001): Errore interno nel server licenze.
LSERVER_E_INVALID_SEQUENCE (5006): La sequenza chiamante non è valida. Molto probabilmente, un'enumerazione precedente non è terminata.
LSERVER_E_SERVER_BUSY (5007): Il server licenze è troppo occupato per elaborare la richiesta.
LSERVER_E_OUTOFMEMORY (5008): Impossibile elaborare la richiesta a causa di memoria insufficiente.
LSERVER_E_INVALID_DATA (5009): I dati nel parametro di ricerca non sono validi.

Valore restituito

Questa funzione restituisce i valori restituiti seguenti.

RPC_S_OK: La chiamata ha avuto esito positivo. Controllare il valore del parametro pdwErrCode per ottenere il codice restituito per la chiamata.
RPC_S_INVALID_ARG: L'argomento non è valido.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
DLL	Mstlsapi.dll

Vedi anche

LSKeyPack
TLSConnectToLsServer
TLSKeyPackEnumNext
TLSKeyPackEnumEnd

Condividi tramite