BCryptEnumAlgorithms-Funktion (bcrypt.h)

Artikel
11/18/2024

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 Algorithmusoperationstypen angibt, die in die Enumeration eingeschlossen werden sollen. Dies kann eine Kombination aus einem oder mehreren der folgenden Werte sein.

Wert	Bedeutung
BCRYPT_CIPHER_OPERATION 0x00000001	Fügen Sie die Verschlüsselungsalgorithmen in die Enumeration ein.
BCRYPT_HASH_OPERATION 0x00000002	Fügen 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	Fügen Sie die Signaturalgorithmen in die Enumeration ein.
BCRYPT_RNG_OPERATION 0x00000020	Schließen Sie die Algorithmen des Zufallszahlengenerators (Random Number Generator, RNG) in die Enumeration ein.
BCRYPT_KEY_DERIVATION_OPERATION 0x00000040	Schließen Sie die Schlüsselableitungsalgorithmen 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 Statuscode zurück, der den Erfolg oder Fehler der Funktion angibt.

Mögliche Rückgabecodes umfassen, aber nicht beschränkt auf Folgendes.

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

Bemerkungen

BCryptEnumAlgorithms kann entweder über den Benutzermodus oder den Kernelmodus aufgerufen werden. Kernelmodus-Aufrufer müssen bei PASSIVE_LEVELIRQL-ausgeführt werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	bcrypt.h
Library	Bcrypt.lib
DLL-	Bcrypt.dll

Freigeben über