BCryptCreateContext-Funktion (bcrypt.h)

Artikel
02/28/2024

[BCryptCreateContext ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die BCryptCreateContext-Funktion erstellt einen neuen CNG-Konfigurationskontext.

Syntax

NTSTATUS BCryptCreateContext(
  [in]           ULONG                 dwTable,
  [in]           LPCWSTR               pszContext,
  [in, optional] PCRYPT_CONTEXT_CONFIG pConfig
);

Parameter

[in] dwTable

Gibt die Konfigurationstabelle an, in der der Kontext erstellt werden soll. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
CRYPT_LOCAL	Erstellen Sie den Kontext in der Konfigurationstabelle "local-machine".
CRYPT_DOMAIN	Dieser Wert steht nicht zur Verwendung zur Verfügung.

[in] pszContext

Ein Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den Bezeichner des zu erstellenden Kontexts enthält.

[in, optional] pConfig

Ein Zeiger auf eine CRYPT_CONTEXT_CONFIG-Struktur , die zusätzliche Konfigurationsdaten für den neuen Kontext enthält. Dieser Parameter kann NULL sein, wenn er nicht benötigt wird.

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

BCryptCreateContext kann nur im Benutzermodus aufgerufen werden.

Anforderungen

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

Freigeben über