Fonction TLSKeyPackEnumBegin
Commence l’énumération par le biais de tous les packs de clés installés sur un 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 lier dynamiquement à Mstlsapi.dll.
Syntaxe
DWORD WINAPI TLSKeyPackEnumBegin(
_In_ TLS_HANDLE hHandle,
_In_ DWORD dwSearchParm,
_In_ BOOL bMatchAll,
_In_ LSKeyPack *lpSearchParm,
_Out_ PDWORD pdwErrCode
);
Paramètres
-
hHandle [in]
-
Gérez 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. Ce paramètre est réservé à une utilisation ultérieure et doit contenir 0xFFFFFFFF.
-
bMatchAll [in]
-
Spécifie s’il faut faire correspondre toutes les valeurs de recherche.
-
lpSearchParm [in]
-
Pointeur vers une structure LSKeyPack 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 |
|