SetContextAttributesA-Funktion (sspi.h)

Artikel
11/20/2024

Ermöglicht einer Transportanwendung, Attribute eines Sicherheitskontexts für ein Sicherheitspaketfestzulegen. Diese Funktion wird nur vom Sicherheitspaket Schannel unterstützt.

Syntax

SECURITY_STATUS SEC_ENTRY SetContextAttributesA(
  [in] PCtxtHandle   phContext,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
  [in] unsigned long cbBuffer
);

Parameter

[in] phContext

Ein Handle für den festzulegenden Sicherheitskontext.

[in] ulAttribute

Das Attribut des festzulegenden Kontexts. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
SECPKG_ATTR_APP_DATA 94	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_SessionAppData Struktur. Legt Anwendungsdaten für die Sitzung fest. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt.
SECPKG_ATTR_EAP_PRF_INFO 101	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_EapPrfInfo Struktur. Legt die pseudo-zufällige Funktion (PRF) fest, die vom Extensible Authentication Protocol (EAP) verwendet wird. Dies ist der Wert, der von einem Aufruf der QueryContextAttributes (Schannel) Funktion zurückgegeben wird, wenn SECPKG_ATTR_EAP_KEY_BLOCK als Wert des ulAttribute--Parameters übergeben wird. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt.
SECPKG_ATTR_EARLY_START 105	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_EarlyStart Struktur. Legt die Funktion "False Start" fest. Informationen zu diesem Feature finden Sie im Erstellen eines schnelleren und sichereren Web- Blogbeitrags.
SECPKG_ATTR_DTLS_MTU 34	Legt den MTU-Wert (maximale Übertragungseinheit) für die Verwendung mit DTLS fest und ruft diesen ab. Wenn DTLS in einem Sicherheitskontext nicht aktiviert ist, wird dieses Attribut nicht unterstützt. Gültige Werte liegen zwischen 200 Bytes und 64 Kb. Der Standardwert DTLS MTU in Schannel beträgt 1096 Byte.
SECPKG_ATTR_KEYING_MATERIAL_INFO 106	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_KeyingMaterialInfo Struktur. Das Schlüsselmaterialexportfeature folgt dem RFC 5705-Standard. Dieses Attribut wird nur vom Schannel-Sicherheitspaket in Windows 10 und Windows Server 2016 oder höher unterstützt.

[in] pBuffer

Ein Zeiger auf eine Struktur, die Werte enthält, auf die die Attribute festgelegt werden sollen. Der Typ der Struktur, auf die verwiesen wird, hängt vom wert ab, der im ulAttribute Parameter angegeben ist.

[in] cbBuffer

Die Größe des pBuffer--Parameters in Byte.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion SEC_E_OK zurück.

Wenn die Funktion fehlschlägt, wird ein Fehlercode ungleich Null zurückgegeben. Der folgende Fehlercode ist einer der möglichen Fehlercodes.

Rückgabecode	Beschreibung
SEC_E_UNSUPPORTED_FUNCTION	Dieser Wert wird vom Schannel-Kernelmodus zurückgegeben, um anzugeben, dass diese Funktion nicht unterstützt wird.

Bemerkungen

Anmerkung

Der Header "sspi.h" definiert SetContextAttributes als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	sspi.h (include Security.h)
Library	Secur32.lib
DLL-	Secur32.dll

Freigeben über