Condividi tramite


Funzione TLSLicenseEnumBegin

Inizia l'enumerazione delle licenze rilasciate dal 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 TLSLicenseEnumBegin(
  _In_  TLS_HANDLE hHandle,
  _In_  DWORD      dwSearchParm,
  _In_  BOOL       bMatchAll,
  _In_  LSLicense  *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. Il parametro può essere una o una combinazione dei valori descritti nell'elenco seguente. Il parametro specifica il tipo di key pack e il key pack da cercare.

LSLICENSE_SEARCH_LICENSEID (0x00000001)

Cercare in base all'ID licenza.

LSLICENSE_SEARCH_KEYPACKID (0x00000002)

Cercare in base all'ID del pacchetto di chiavi.

LSLICENSE_SEARCH_MACHINENAME (0x00000008)

Cercare in base al nome del computer.

LSLICENSE_SEARCH_USERNAME (0x00000010)

Cercare in base al nome utente.

LSLICENSE_SEARCH_ISSUEDATE (0x00000080)

Cerca in base alla data del problema.

LSLICENSE_SEARCH_EXPIREDATE (0x00000100)

Cerca in base alla data di scadenza.

LSLICENSE_SEARCH_ NUMLICENSES (0x00000200)

Cercare per numero di licenze.

LSLICENSE_SEARCH_ ENTRY_STATUS (0x20000000)

Eseguire la ricerca in base allo stato di immissione.

LSLICENSE_EXSEARCH_LICENSESTATUS (0x00100000)

Cercare in base allo stato della licenza.

LSKEYPACK_SEARCH_ALL (0xFFFFFFFF)

Cercare tutte le licenze.

bMatchAll [in]

Specifica se trovare la corrispondenza con tutti i valori di ricerca.

lpSearchParm [in]

Puntatore a una struttura LSLicense 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

LSLicense

TLSConnectToLsServer

TLSLicenseEnumNext

TLSLicenseEnumEnd