BCryptEnumAlgorithms, fonction (bcrypt.h)

Article
07/16/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 de contrat 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 de générateur de nombres aléatoires (RNG) 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 lorsqu’il 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 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
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é 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

Partager via