BCryptConfigureContext-Funktion (bcrypt.h)

[BCryptConfigureContext 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 BCryptConfigureContext-Funktion legt die Konfigurationsinformationen für einen vorhandenen CNG-Kontext fest.

Syntax

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

Parameter

[in] dwTable

Gibt die Konfigurationstabelle an, in der der Kontext vorhanden ist. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
CRYPT_LOCAL	Der Kontext ist in der Konfigurationstabelle für den lokalen Computer vorhanden.
CRYPT_DOMAIN	Dieser Wert steht nicht zur Verwendung zur Verfügung.

[in] pszContext

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Bezeichner des Kontexts enthält, für den die Konfigurationsinformationen festgelegt werden sollen.

[in] pConfig

Die Adresse einer CRYPT_CONTEXT_CONFIG-Struktur , die die neuen Kontextkonfigurationsinformationen enthält.

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

BCryptConfigureContext 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

Weitere Informationen

CRYPT_CONTEXT_CONFIG