Fonction TLSLicenseEnumBegin
Commence l’énumération des licences émises par le serveur de licences Bureau à distance en fonction des critères de recherche.
Notes
Cette fonction n’a pas de fichier d’en-tête associé ni de bibliothèque d’importation. Pour appeler cette fonction, vous devez créer un fichier d’en-tête défini par l’utilisateur et utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Mstlsapi.dll.
Syntaxe
DWORD WINAPI TLSLicenseEnumBegin(
_In_ TLS_HANDLE hHandle,
_In_ DWORD dwSearchParm,
_In_ BOOL bMatchAll,
_In_ LSLicense *lpSearchParm,
_Out_ PDWORD pdwErrCode
);
Paramètres
-
hHandle [in]
-
Gérer vers un serveur de licences Bureau à distance. Spécifiez un handle ouvert par la fonction TLSConnectToLsServer .
-
dwSearchParm [in]
-
Spécifie les critères de recherche. Le paramètre peut être une ou une combinaison des valeurs décrites dans la liste suivante. Le paramètre spécifie le type de pack de clés et le pack de clés à rechercher.
-
LSLICENSE_SEARCH_LICENSEID (0x00000001)
-
Recherchez par ID de licence.
-
LSLICENSE_SEARCH_KEYPACKID (0x00000002)
-
Recherchez par ID de pack de clés.
-
LSLICENSE_SEARCH_MACHINENAME (0x00000008)
-
Recherchez par nom de machine.
-
LSLICENSE_SEARCH_USERNAME (0x00000010)
-
Recherchez par nom d’utilisateur.
-
LSLICENSE_SEARCH_ISSUEDATE (0x00000080)
-
Recherchez par date de problème.
-
LSLICENSE_SEARCH_EXPIREDATE (0x00000100)
-
Recherchez par date d’expiration.
-
LSLICENSE_SEARCH_ NUMLICENSES (0x00000200)
-
Recherchez par nombre de licences.
-
LSLICENSE_SEARCH_ ENTRY_STATUS (0x20000000)
-
Recherchez par status d’entrée.
-
LSLICENSE_EXSEARCH_LICENSESTATUS (0x00100000)
-
Recherchez par status de licence.
-
LSKEYPACK_SEARCH_ALL (0xFFFFFFFF)
-
Rechercher toutes les licences.
bMatchAll [in]
Spécifie s’il faut faire correspondre toutes les valeurs de recherche.
lpSearchParm [in]
Pointeur vers une structure LSLicense qui spécifie les paramètres de recherche à rechercher.
pdwErrCode [out]
Pointeur vers une variable qui reçoit l’un des codes d’erreur suivants au retour.
LSERVER_S_SUCCESS (0)
L’appel est réussi.
LSERVER_E_INTERNAL_ERROR (5001)
Erreur interne dans le serveur de licences.
LSERVER_E_INVALID_SEQUENCE (5006)
La séquence d’appel n’était pas valide. Très probablement, une énumération précédente n’a pas pris fin.
LSERVER_E_SERVER_BUSY (5007)
Le serveur de licences est trop occupé pour traiter la demande.
LSERVER_E_OUTOFMEMORY (5008)
Impossible de traiter la demande en raison d’une mémoire insuffisante.
LSERVER_E_INVALID_DATA (5009)
Les données du paramètre de recherche ne sont pas valides.
Valeur retournée
Cette fonction retourne les valeurs de retour possibles suivantes.
-
RPC_S_OK
-
L’appel a réussi. Vérifiez la valeur du paramètre pdwErrCode pour obtenir le code de retour de l’appel.
-
RPC_S_INVALID_ARG
-
L’argument n’était pas valide.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| DLL |
|