Condividi tramite


Funzione TLSKeyPackEnumBegin

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