SetContextAttributesA-Funktion (sspi.h)

Artikel
08/26/2023

Ermöglicht einer Transportanwendung das Festlegen von Attributen eines Sicherheitskontexts für ein Sicherheitspaket. Diese Funktion wird nur vom Schannel-Sicherheitspaket 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 einen der folgenden Werte annehmen.

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-random-Funktion (PRF) fest, die vom Extensible Authentication Protocol (EAP) verwendet wird. Dies ist der Wert, der von einem Aufruf der Funktion QueryContextAttributes (Schannel) 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 das Feature "Falscher Start" fest. Weitere Informationen zu diesem Feature finden Sie im Blogbeitrag Erstellen eines schnelleren und sichereren Webblogbeitrags .
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 DTLS-MTU-Standardwert 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 Feature zum Exportieren von Schlüsselmaterial folgt dem RFC 5705-Standard. Dieses Attribut wird nur vom Schannel-Sicherheitspaket in Windows 10 und Windows Server 2016 oder höheren Versionen 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 Bytes.

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.

Hinweise

Hinweis

Der sspi.h-Header 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


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sspi.h (einschließlich Security.h)
Bibliothek	Secur32.lib
DLL	Secur32.dll

Freigeben über