QueryContextAttributesExA-Funktion (sspi.h)

Artikel
11/20/2024

Ermöglicht einer Transportanwendung das Abfragen eines Sicherheitspakets für bestimmte Attribute eines Sicherheitskontexts kontext.

Syntax

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

Parameter

[in] phContext

Ein Handle für den Sicherheitskontext, der abgefragt werden soll.

[in] ulAttribute

Gibt das Attribut des zurückzugebenden Kontexts an. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
SECPKG_ATTR_ACCESS_TOKEN 18	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_AccessToken Struktur. Gibt ein Handle an das Zugriffstoken zurück.
SECPKG_ATTR_APP_DATA 0x5e	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_SessionAppData Struktur. Gibt Anwendungsdaten für die Sitzung zurück oder gibt diese an. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt.
SECPKG_ATTR_AUTHORITY 6	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Authority Struktur. Fragt den Namen der Authentifizierungsautorität ab.
SECPKG_ATTR_CLIENT_SPECIFIED_TARGET 27	Der pBuffer--Parameter enthält einen Zeiger auf eine SecPkgContext_ClientSpecifiedTarget Struktur, die den Dienstprinzipalnamen (SPN) des ursprünglich vom Client bereitgestellten Ziels darstellt. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.
SECPKG_ATTR_CONNECTION_INFO 0x5a	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_ConnectionInfo Struktur. Gibt detaillierte Informationen zur hergestellten Verbindung zurück. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt.
SECPKG_ATTR_CREDS_2 0x80000086	Der pBuffer--Parameter enthält einen Zeiger auf eine SecPkgContext_ClientCreds Struktur, die Clientanmeldeinformationen angibt. Wenn die Clientanmeldeinformationen Benutzername und Kennwort sind, ist der Puffer eine gepackte KERB_INTERACTIVE_LOGON Struktur. Wenn die Clientanmeldeinformationen Benutzername und Smartcard-PIN sind, ist der Puffer eine verpackte KERB_CERTIFICATE_LOGON Struktur. Wenn es sich bei den Clientanmeldeinformationen um eine Onlineidentität handelt, handelt es sich bei dem Puffer um eine gemarstische SEC_WINNT_AUTH_IDENTITY_EX2 Struktur. Dieses Attribut wird nur auf dem CredSSP-Server unterstützt. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.
SECPKG_ATTR_DCE_INFO 3	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_DceInfo Struktur. Abfragen nach Autorisierungsdaten, die von DCE-Diensten verwendet werden.
SECPKG_ATTR_ENDPOINT_BINDINGS 26	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Bindings Struktur, die Kanalbindungsinformationen angibt. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.
SECPKG_ATTR_EAP_KEY_BLOCK 0x5b	Der pBuffer--Parameter enthält einen Zeiger auf eine SecPkgContext_EapKeyBlock Struktur. Abfragen nach Schlüsseldaten, die vom EAP TLS-Protokoll verwendet werden. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt.
SECPKG_ATTR_FLAGS 14	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Flags Struktur. Gibt Informationen zu den ausgehandelten Kontextkennzeichnungen zurück.
SECPKG_ATTR_ISSUER_LIST_EX 0x59	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_IssuerListInfoEx Struktur. Gibt eine Liste der Zertifikataussteller zurück, die vom Server akzeptiert werden. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt.
SECPKG_ATTR_KEY_INFO 5	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_KeyInfo Struktur. Fragt Informationen zu den schlüsseln ab, die in einem Sicherheitskontext verwendet werden.
SECPKG_ATTR_LAST_CLIENT_TOKEN_STATUS 30	Der pBuffer--Parameter enthält einen Zeiger auf eine SecPkgContext_LastClientTokenStatus Struktur, die angibt, ob das Token aus dem letzten Aufruf der InitializeSecurityContext--Funktion das letzte Token vom Client ist. Dieser Wert wird nur von den Sicherheitspaketen Negotiate, Kerberos und NTLM unterstützt. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.
SECPKG_ATTR_LIFESPAN 2	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Lifespan Struktur. Fragt die Lebensdauer des Kontexts ab.
SECPKG_ATTR_LOCAL_CERT_CONTEXT 0x54	Der pBuffer Parameter enthält einen Zeiger auf eine PCCERT_CONTEXT Struktur. Sucht einen Zertifikatkontext, der ein lokales Endzertifikat enthält. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt.
SECPKG_ATTR_LOCAL_CRED	Der pBuffer--Parameter enthält einen Zeiger auf eine SecPkgContext_LocalCredentialInfo Struktur. (veraltet) Abgelöst von SECPKG_ATTR_LOCAL_CERT_CONTEXT.
SECPKG_ATTR_NAMES 1	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Names Struktur. Fragt den namen ab, der dem Kontext zugeordnet ist.
SECPKG_ATTR_NATIVE_NAMES 13	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_NativeNames Struktur. Gibt den Prinzipalnamen (CNAME) aus dem ausgehenden Ticket zurück.
SECPKG_ATTR_NEGOTIATION_INFO 12	Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext_NegotiationInfo Struktur. Gibt Informationen über das Sicherheitspaket zurück, das mit dem Aushandlungsprozess und dem aktuellen Status der Aushandlung für die Verwendung dieses Pakets verwendet werden soll.
SECPKG_ATTR_PACKAGE_INFO 10	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_PackageInfo Struktur. Gibt Informationen zum verwendeten SSP zurück.
SECPKG_ATTR_PASSWORD_EXPIRY 8	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_PasswordExpiry Struktur. Gibt Kennwortablaufinformationen zurück.
SECPKG_ATTR_REMOTE_CERT_CONTEXT 0x53	Der pBuffer Parameter enthält einen Zeiger auf eine PCCERT_CONTEXT Struktur. Sucht einen Zertifikatkontext, der das vom Server bereitgestellte Endzertifikat enthält. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt.
SECPKG_ATTR_ROOT_STORE 0x55	Der pBuffer-Parameter enthält einen Zeiger auf ein HCERTCONTEXT-. Sucht einen Zertifikatkontext, der ein vom Stammspeicher bereitgestelltes Zertifikat enthält.
SECPKG_ATTR_SESSION_KEY 9	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_SessionKey Struktur. Gibt Informationen zu den Sitzungsschlüsseln zurück.
SECPKG_ATTR_SESSION_INFO 0x5d	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_SessionInfo Struktur. Gibt Informationen zur Sitzung zurück. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt.
SECPKG_ATTR_SIZES 0	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Sizes Struktur. Fragt die Größe der strukturen ab, die in den Nachrichtenfunktionen verwendet werden.
SECPKG_ATTR_STREAM_SIZES 4	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_StreamSizes Struktur. Fragt die Größe der verschiedenen Teile eines Datenstroms ab, die in den Nachrichtenfunktionen verwendet werden. Dieses Attribut wird nur vom Schannel-Sicherheitspaket unterstützt.
SECPKG_ATTR_SUBJECT_SECURITY_ATTRIBUTES 124	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_SubjectAttributes Struktur. Dieser Wert gibt Informationen zu den Sicherheitsattributen für die Verbindung zurück. Dieser Wert wird nur auf dem CredSSP-Server unterstützt. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.
SECPKG_ATTR_SUPPORTED_SIGNATURES 0x66	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_SupportedSignatures Struktur. Dieser Wert gibt Informationen zu den Signaturtypen zurück, die für die Verbindung unterstützt werden. Dieser Wert wird nur vom Schannel-Sicherheitspaket unterstützt. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.
SECPKG_ATTR_TARGET_INFORMATION 17	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_TargetInformation Struktur. Gibt Informationen zum Namen des Remoteservers zurück.
SECPKG_ATTR_UNIQUE_BINDINGS 25	Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Bindings Struktur, die Kanalbindungsinformationen angibt. Dieser Wert wird nur vom Schannel-Sicherheitspaket unterstützt. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht unterstützt.

[out] pBuffer

Ein Zeiger auf eine Struktur, die die Attribute empfängt. 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, wird der Rückgabewert SEC_E_OK.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode ungleich Null.

Bemerkungen

Anmerkung

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