BCryptAddContextFunction-Funktion (bcrypt.h)

Artikel
02/26/2024

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

Die BCryptAddContextFunction-Funktion fügt der Liste der Funktionen, die von einem vorhandenen CNG-Kontext unterstützt werden, eine kryptografische Funktion hinzu.

Syntax

NTSTATUS BCryptAddContextFunction(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] ULONG   dwPosition
);

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 des lokalen Computers 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, dem die Funktion hinzugefügt werden soll.

[in] dwInterface

Gibt die kryptografische Schnittstelle an, der die Funktion hinzugefügt werden soll. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE	Fügen Sie die Funktion der Liste der asymmetrischen Verschlüsselungsfunktionen hinzu.
BCRYPT_CIPHER_INTERFACE	Fügen Sie die Funktion der Liste der Verschlüsselungsfunktionen hinzu.
BCRYPT_HASH_INTERFACE	Fügen Sie die Funktion zur Liste der Hashfunktionen hinzu.
BCRYPT_RNG_INTERFACE	Fügen Sie die Funktion der Liste der Funktionen des Zufallsgenerators hinzu.
BCRYPT_SECRET_AGREEMENT_INTERFACE	Fügen Sie die Funktion der Liste der Funktionen für geheime Vereinbarungen hinzu.
BCRYPT_SIGNATURE_INTERFACE	Fügen Sie die Funktion der Liste der Signaturfunktionen hinzu.
NCRYPT_KEY_STORAGE_INTERFACE	Fügen Sie die Funktion zur Liste der Schlüsselspeicherfunktionen hinzu.
NCRYPT_SCHANNEL_INTERFACE	Fügen Sie die Funktion zur Liste der Schannel-Funktionen hinzu.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE	Fügen Sie die Funktion der Liste der Signatursammlungen hinzu, 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 mit NULL-Beendigung, die den Bezeichner der hinzuzufügenden kryptografischen Funktion enthält.

[in] dwPosition

Gibt die Position in der Liste an, an der diese Funktion eingefügt werden soll. Die Funktion wird an dieser Position vor allen vorhandenen Funktionen eingefügt. Der CRYPT_PRIORITY_TOP Wert wird verwendet, um die Funktion am Anfang der Liste einzufügen. Der CRYPT_PRIORITY_BOTTOM Wert wird verwendet, um die Funktion am Ende der Liste einzufügen.

Rückgabewert

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

Mögliche Rückgabecodes umfassen folgendes, sind aber nicht darauf beschränkt.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_INVALID_PARAMETER	Mindestens ein Parameter ist ungültig.
STATUS_NO_MEMORY	Ein Fehler bei der Speicherzuordnung ist aufgetreten.
STATUS_NOT_FOUND	Der Kontext konnte nicht gefunden werden.

Hinweise

Wenn die hinzugefügte Funktion bereits in der Liste enthalten ist, wird sie entfernt und an der neuen Position eingefügt.

BCryptAddContextFunction 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

BCryptRemoveContextFunction

Freigeben über