BCryptEnumProviders-Funktion (bcrypt.h)

  • Artikel

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 Unicode-Zeichenfolge mit NULL-Endung, die den Algorithmus identifiziert, für den die Anbieter abgerufen werden sollen. Dies kann einer 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 von BCRYPT_PROVIDER_NAME Strukturen, um die Auflistung von Anbietern zu empfangen, die den angegebenen Algorithmus unterstützen. Der Parameter pImplCount 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 Funktion BCryptFreeBuffer übergeben wird.

[in] dwFlags

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

Rückgabewert

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

Mögliche Rückgabecodes sind u. a. die folgenden:

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

Hinweise

BCryptEnumProviders kann entweder aus dem Benutzermodus oder dem Kernelmodus aufgerufen werden. Aufrufer im Kernelmodus 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

Weitere Informationen

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer