BCryptEnumProviders, fonction (bcrypt.h)
La fonction BCryptEnumProviders obtient tous les fournisseurs CNG qui prennent en charge un algorithme spécifié.
Syntaxe
NTSTATUS BCryptEnumProviders(
[in] LPCWSTR pszAlgId,
[out] ULONG *pImplCount,
[out] BCRYPT_PROVIDER_NAME **ppImplList,
[in] ULONG dwFlags
);
Paramètres
[in] pszAlgId
Pointeur vers une chaîne Unicode terminée par null qui identifie l’algorithme pour obtenir les fournisseurs. Il peut s’agir de l’un des identificateurs d’algorithme CNG prédéfinis ou d’un autre identificateur d’algorithme.
[out] pImplCount
Pointeur vers une variable
[out] ppImplList
Adresse d’un tableau de structures BCRYPT_PROVIDER_NAME pour recevoir la collection de fournisseurs qui prennent en charge l’algorithme spécifié. Le paramètre pImplCount reçoit le nombre d’éléments de ce tableau. Cette mémoire doit être libérée lorsqu’elle n’est plus nécessaire en passant ce pointeur à la fonction BCryptFreeBuffer.
[in] dwFlags
Ensemble d’indicateurs qui modifie le comportement de cette fonction. Il n’existe actuellement aucun indicateur défini. Ce paramètre doit donc être égal à zéro.
Valeur de retour
Retourne un code d’état qui indique la réussite ou l’échec de la fonction.
Les codes de retour possibles incluent, mais ne sont pas limités à, les éléments suivants.
| Retourner le code | Description |
|---|---|
|
La fonction a réussi. |
|
Un ou plusieurs paramètres ne sont pas valides. |
|
Un échec d’allocation de mémoire s’est produit. |
Remarques
BCryptEnumProviders peuvent être appelés en mode utilisateur ou en mode noyau. Les appelants en mode noyau doivent s’exécuter à PASSIVE_LEVELIRQL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau | Applications UWP] |
| serveur minimum pris en charge | Windows Server 2008 [applications de bureau | Applications UWP] |
| plateforme cible | Windows |
| d’en-tête | bcrypt.h |
| bibliothèque | Bcrypt.lib |
| DLL | Bcrypt.dll |