QueryContextAttributesExA-Funktion (sspi.h)

Artikel
03/08/2023

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

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 abzufragenden Sicherheitskontext.

[in] ulAttribute

Gibt das Attribut des zurückzugebenden Kontexts an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
SECPKG_ATTR_ACCESS_TOKEN 18	Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext_AccessToken Struktur. Gibt ein Handle für 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 Sicherheitspaket Schannel unterstützt.
SECPKG_ATTR_AUTHORITY 6	Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext_Authority Struktur. Fragt den Namen der authentifizierenden Autorität ab.
SECPKG_ATTR_CLIENT_SPECIFIED_TARGET 27	Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext_ClientSpecifiedTarget Struktur, die den Dienstprinzipalnamen (Service Principal Name , SPN) des anfänglichen Ziels darstellt, das vom Client bereitgestellt wird. 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 eingerichteten Verbindung zurück. Dieses Attribut wird nur vom Sicherheitspaket Schannel 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 smart Karte PIN sind, ist der Puffer eine gepackte KERB_CERTIFICATE_LOGON Struktur. Wenn es sich bei den Clientanmeldeinformationen um Onlineidentitätsanmeldeinformationen 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 von 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 Sicherheitspaket Schannel 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 von Schlüsseldaten, die vom EAP TLS-Protokoll verwendet werden. Dieses Attribut wird nur vom Sicherheitspaket Schannel unterstützt.
SECPKG_ATTR_FLAGS 14	Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext_Flags-Struktur . Gibt Informationen zu den ausgehandelten Kontextflags zurück.
SECPKG_ATTR_ISSUER_LIST_EX 0x59	Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext_IssuerListInfoEx Struktur. Gibt eine Liste von Zertifikatausstellern zurück, die vom Server akzeptiert werden. Dieses Attribut wird nur vom Sicherheitspaket Schannel 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 des letzten Aufrufs 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 Sicherheitspaket Schannel unterstützt.
SECPKG_ATTR_LOCAL_CRED	Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext_LocalCredentialInfo-Struktur . (Veraltet) Ersetzt durch SECPKG_ATTR_LOCAL_CERT_CONTEXT.
SECPKG_ATTR_NAMES 1	Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext_Names-Struktur . Fragt den dem Kontext zugeordneten Namen ab.
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 verwendet werden soll, und den aktuellen Zustand der Aushandlung für die Verwendung dieses Pakets.
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 Sicherheitspaket Schannel unterstützt.
SECPKG_ATTR_ROOT_STORE 0x55	Der pBuffer-Parameter enthält einen Zeiger auf einen 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 Sicherheitspaket Schannel unterstützt.
SECPKG_ATTR_SIZES 0	Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext_Sizes-Struktur . Fragt die Größen 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ößen der verschiedenen Teile eines Datenstroms ab, die in den Nachrichtenfunktionen verwendet werden. Dieses Attribut wird nur vom Sicherheitspaket Schannel 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 Sicherheitspaket Schannel 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 über den 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 Sicherheitspaket Schannel 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 Bytes.

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 nonzero.

Hinweise

Hinweis

Der sspi.h-Header definiert QueryContextAttributesEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
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