BCryptEnumProviders-Funktion (bcrypt.h)

Artikel
07/16/2024

Die BCryptEnumProviders Funktion ruft alle CNG-Anbieter ab, die einen angegebenen Algorithmus unterstützen.

Syntax

NTSTATUS BCryptEnumProviders(
  [in]  LPCWSTR              pszAlgId,
  [out] ULONG                *pImplCount,
  [out] BCRYPT_PROVIDER_NAME **ppImplList,
  [in]  ULONG                dwFlags
);

Parameter

[in] pszAlgId

Ein Zeiger auf eine mit Null beendete Unicode-Zeichenfolge, die den Algorithmus identifiziert, für den die Anbieter abgerufen werden sollen. Dies kann eine der vordefinierten CNG-Algorithmusbezeichner oder ein anderer Algorithmusbezeichner sein.

[out] pImplCount

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

[out] ppImplList

Die Adresse eines Arrays BCRYPT_PROVIDER_NAME Strukturen, um die Sammlung von Anbietern zu empfangen, die den angegebenen Algorithmus unterstützen. Der pImplCount Parameter empfängt die Anzahl der Elemente in diesem Array. Dieser Speicher muss freigegeben werden, wenn er nicht mehr benötigt wird, indem dieser Zeiger an die BCryptFreeBuffer Funktion übergeben wird.

[in] dwFlags

Eine Reihe von Flags, die das Verhalten dieser Funktion ändern. Es sind derzeit keine Flags definiert, daher muss dieser Parameter null sein.

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

BCryptEnumProviders 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

Siehe auch

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer

Freigeben über