Partager via

BCryptEnumProviders, fonction (bcrypt.h)

  • Article

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 lequel 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 ULONG pour recevoir le nombre d’éléments dans le tableau ppImplList .

[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 dans ce tableau. Cette mémoire doit être libérée quand 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. Aucun indicateur n’étant actuellement défini, ce paramètre doit être égal à zéro.

Valeur retournée

Retourne un code status qui indique la réussite ou l’échec de la fonction.

Les codes de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour Description
STATUS_SUCCESS
 La fonction a réussi.
STATUS_INVALID_PARAMETER
 Un ou plusieurs paramètres ne sont pas valides.
STATUS_NO_MEMORY
 Un échec d’allocation de mémoire s’est produit.

Remarques

BCryptEnumProviders peut être appelé à partir du mode utilisateur ou du mode noyau. Les appelants en mode noyau doivent s’exécuter à PASSIVE_LEVELIRQL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête bcrypt.h
Bibliothèque Bcrypt.lib
DLL Bcrypt.dll

Voir aussi

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer