BCryptEnumAlgorithms, fonction (bcrypt.h)

Article
02/28/2024

La fonction BCryptEnumAlgorithms obtient une liste des identificateurs d’algorithme inscrits.

Syntaxe

NTSTATUS BCryptEnumAlgorithms(
  [in]  ULONG                       dwAlgOperations,
  [out] ULONG                       *pAlgCount,
  [out] BCRYPT_ALGORITHM_IDENTIFIER **ppAlgList,
  [in]  ULONG                       dwFlags
);

Paramètres

[in] dwAlgOperations

Valeur qui spécifie les types d’opérations d’algorithme à inclure dans l’énumération. Il peut s’agir d’une combinaison d’une ou plusieurs des valeurs suivantes.

Valeur	Signification
BCRYPT_CIPHER_OPERATION 0x00000001	Incluez les algorithmes de chiffrement dans l’énumération.
BCRYPT_HASH_OPERATION 0x00000002	Incluez les algorithmes de hachage dans l’énumération.
BCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION 0x00000004	Incluez les algorithmes de chiffrement asymétrique dans l’énumération.
BCRYPT_SECRET_AGREEMENT_OPERATION 0x00000008	Incluez les algorithmes d’accord de secret dans l’énumération.
BCRYPT_SIGNATURE_OPERATION 0x00000010	Incluez les algorithmes de signature dans l’énumération.
BCRYPT_RNG_OPERATION 0x00000020	Incluez les algorithmes RNG (Random Number Generator) dans l’énumération.

[out] pAlgCount

Pointeur vers une variable ULONG pour recevoir le nombre d’éléments dans le tableau ppAlgList .

[out] ppAlgList

Adresse d’un pointeur de structure BCRYPT_ALGORITHM_IDENTIFIER pour recevoir le tableau d’identificateurs d’algorithme inscrits. Ce pointeur doit être passé à la fonction BCryptFreeBuffer quand elle n’est plus nécessaire.

[in] dwFlags

Ensemble d’indicateurs qui modifient le comportement de cette fonction. Aucun indicateur n’est défini pour cette fonction.

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

BCryptEnumAlgorithms 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

Partager via