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 |
|