BCryptRemoveContextFunction-Funktion (bcrypt.h)

  • Artikel

[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