Funzione TLSLicenseEnumBegin

Articolo
06/13/2023

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

Condividi tramite