Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_AccessToken Struktur.
Gibt ein Handle an das Zugriffstoken zurück. |
|
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. |
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Authority Struktur.
Fragt den Namen der Authentifizierungsautorität ab. |
|
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. |
|
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. |
|
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. |
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_DceInfo Struktur.
Abfragen nach Autorisierungsdaten, die von DCE-Diensten verwendet werden. |
|
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. |
|
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. |
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Flags Struktur.
Gibt Informationen zu den ausgehandelten Kontextkennzeichnungen zurück. |
|
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. |
|
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. |
|
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. |
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Lifespan Struktur.
Fragt die Lebensdauer des Kontexts ab. |
|
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. |
|
Der pBuffer--Parameter enthält einen Zeiger auf eine SecPkgContext_LocalCredentialInfo Struktur. (veraltet) Abgelöst von SECPKG_ATTR_LOCAL_CERT_CONTEXT. |
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_Names Struktur.
Fragt den namen ab, der dem Kontext zugeordnet ist. |
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_NativeNames Struktur.
Gibt den Prinzipalnamen (CNAME) aus dem ausgehenden Ticket zurück. |
|
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. |
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_PackageInfo Struktur.
Gibt Informationen zum verwendeten SSP zurück. |
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_PasswordExpiry Struktur.
Gibt Kennwortablaufinformationen zurück. |
|
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. |
|
Der pBuffer-Parameter enthält einen Zeiger auf ein HCERTCONTEXT-. Sucht einen Zertifikatkontext, der ein vom Stammspeicher bereitgestelltes Zertifikat enthält. |
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_SessionKey Struktur.
Gibt Informationen zu den Sitzungsschlüsseln zurück. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Der pBuffer Parameter enthält einen Zeiger auf eine SecPkgContext_TargetInformation Struktur.
Gibt Informationen zum Namen des Remoteservers zurück. |
|
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 |