Freigeben über

BCryptConfigureContextFunction-Funktion (bcrypt.h)

[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

  • Last updated on