BCryptConfigureContextFunction-Funktion (bcrypt.h)

Artikel
02/26/2024

[BCryptConfigureContextFunction 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 Funktion BCryptConfigureContextFunction legt die Konfigurationsinformationen für die kryptografische Funktion eines vorhandenen CNG-Kontexts fest.

Syntax

NTSTATUS BCryptConfigureContextFunction(
  [in] ULONG                          dwTable,
  [in] LPCWSTR                        pszContext,
  [in] ULONG                          dwInterface,
  [in] LPCWSTR                        pszFunction,
  [in] PCRYPT_CONTEXT_FUNCTION_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 der kryptografischen Funktion festgelegt werden sollen.

[in] dwInterface

Gibt die kryptografische Schnittstelle an, für die die Funktionskonfigurationsinformationen festgelegt werden sollen. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE	Legen Sie die Funktionskonfigurationsinformationen in der Liste der asymmetrischen Verschlüsselungsfunktionen fest.
BCRYPT_CIPHER_INTERFACE	Legen Sie die Funktionskonfigurationsinformationen in der Liste der Verschlüsselungsfunktionen fest.
BCRYPT_HASH_INTERFACE	Legen Sie die Funktionskonfigurationsinformationen in der Liste der Hashfunktionen fest.
BCRYPT_RNG_INTERFACE	Legen Sie die Funktionskonfigurationsinformationen in der Liste der Zufallszahlengeneratorfunktionen fest.
BCRYPT_SECRET_AGREEMENT_INTERFACE	Legen Sie die Funktionskonfigurationsinformationen in der Liste der Geheimnisvereinbarungsfunktionen fest.
BCRYPT_SIGNATURE_INTERFACE	Legen Sie die Funktionskonfigurationsinformationen in der Liste der Signaturfunktionen fest.
NCRYPT_KEY_STORAGE_INTERFACE	Legen Sie die Funktionskonfigurationsinformationen in der Liste der wichtigsten Speicherfunktionen fest.
NCRYPT_SCHANNEL_INTERFACE	Legen Sie die Funktionskonfigurationsinformationen in der Liste der Schannel-Funktionen fest.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE	Legen Sie die Funktionskonfigurationsinformationen in der Liste der Signatursammlungen fest, die Schannel für TLS 1.2 akzeptiert. Windows Vista und Windows Server 2008: Dieser Wert wird nicht unterstützt.

[in] pszFunction

Ein Zeiger auf eine Unicode-Zeichenfolge, die null endet und den Bezeichner der kryptografischen Funktion enthält, für die die Konfigurationsinformationen festgelegt werden sollen.

[in] pConfig

Die Adresse einer CRYPT_CONTEXT_FUNCTION_CONFIG-Struktur , die die neuen Funktionskonfigurationsinformationen 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

BCryptConfigureContextFunction 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_FUNCTION_CONFIG

Freigeben über