Partager via


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
Mstlsapi.dll

Voir aussi

LSLicense

TLSConnectToLsServer

TLSLicenseEnumNext

TLSLicenseEnumEnd