BCryptRemoveContextFunction-Funktion (bcrypt.h)

Artikel
02/26/2024

[BCryptRemoveContextFunction 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 BCryptRemoveContextFunction-Funktion entfernt eine kryptografische Funktion aus der Liste der Funktionen, die von einem vorhandenen CNG-Kontext unterstützt werden.

Syntax

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

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, aus dem die Funktion entfernt werden soll.

[in] dwInterface

Gibt die kryptografische Schnittstelle an, aus der die Funktion entfernt werden soll. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE	Entfernen Sie die Funktion aus der Liste der asymmetrischen Verschlüsselungsfunktionen.
BCRYPT_CIPHER_INTERFACE	Entfernen Sie die Funktion aus der Liste der Verschlüsselungsfunktionen.
BCRYPT_HASH_INTERFACE	Entfernen Sie die Funktion aus der Liste der Hashfunktionen.
BCRYPT_RNG_INTERFACE	Entfernen Sie die Funktion aus der Liste der Funktionen des Zufallsgenerators.
BCRYPT_SECRET_AGREEMENT_INTERFACE	Entfernen Sie die Funktion aus der Liste der Funktionen für geheime Vereinbarungen.
BCRYPT_SIGNATURE_INTERFACE	Entfernen Sie die Funktion aus der Liste der Signaturfunktionen.
NCRYPT_KEY_STORAGE_INTERFACE	Entfernen Sie die Funktion aus der Liste der Schlüsselspeicherfunktionen.
NCRYPT_SCHANNEL_INTERFACE	Entfernen Sie die Funktion aus der Liste der Schannel-Funktionen.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE	Entfernen Sie die Funktion aus der Liste der Signatursammlungen, 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 mit NULL beendete Unicode-Zeichenfolge, die den Bezeichner der zu entfernenden kryptografischen Funktion enthält.

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_NOT_FOUND	Der angegebene Kontext oder die angegebene Funktion konnte nicht gefunden werden.

Hinweise

BCryptRemoveContextFunction 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

BCryptAddContextFunction

Freigeben über