BCryptEnumAlgorithms-Funktion (bcrypt.h)

Artikel
08/22/2023

Die BCryptEnumAlgorithms-Funktion ruft eine Liste der registrierten Algorithmusbezeichner ab.

Syntax

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

Parameter

[in] dwAlgOperations

Ein Wert, der die Algorithmusvorgangstypen angibt, die in die Enumeration eingeschlossen werden sollen. Dies kann eine Kombination aus mindestens einem der folgenden Werte sein.

Wert	Bedeutung
BCRYPT_CIPHER_OPERATION 0x00000001	Schließen Sie die Verschlüsselungsalgorithmen in die Enumeration ein.
BCRYPT_HASH_OPERATION 0x00000002	Schließen Sie die Hashalgorithmen in die Enumeration ein.
BCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION 0x00000004	Schließen Sie die asymmetrischen Verschlüsselungsalgorithmen in die Enumeration ein.
BCRYPT_SECRET_AGREEMENT_OPERATION 0x00000008	Schließen Sie die Algorithmen für geheime Vereinbarungen in die Enumeration ein.
BCRYPT_SIGNATURE_OPERATION 0x00000010	Schließen Sie die Signaturalgorithmen in die Enumeration ein.
BCRYPT_RNG_OPERATION 0x00000020	Schließen Sie die Algorithmen des Zufallszahlengenerators (RNG) in die Enumeration ein.

[out] pAlgCount

Ein Zeiger auf eine ULONG-Variable , um die Anzahl der Elemente im ppAlgList-Array zu empfangen.

[out] ppAlgList

Die Adresse eines BCRYPT_ALGORITHM_IDENTIFIER Strukturzeigers, um das Array registrierter Algorithmusbezeichner zu empfangen. Dieser Zeiger muss an die BCryptFreeBuffer-Funktion übergeben werden, wenn er nicht mehr benötigt wird.

[in] dwFlags

Eine Reihe von Flags, die das Verhalten dieser Funktion ändern. Für diese Funktion sind keine Flags definiert.

Rückgabewert

Gibt einen status Code zurück, der den Erfolg oder Fehler der Funktion angibt.

Mögliche Rückgabecodes umfassen folgendes, sind aber nicht darauf beschränkt.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_INVALID_PARAMETER	Mindestens ein Parameter ist ungültig.
STATUS_NO_MEMORY	Ein Fehler bei der Speicherzuordnung ist aufgetreten.

Hinweise

BCryptEnumAlgorithms kann entweder im Benutzermodus oder im Kernelmodus aufgerufen werden. Kernelmodusaufrufer müssen in PASSIVE_LEVELIRQL ausgeführt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	bcrypt.h
Bibliothek	Bcrypt.lib
DLL	Bcrypt.dll