QueryContextAttributes(Digest)-Funktion

Die QueryContextAttributes (Digest)-Funktion ermöglicht einer Transportanwendung, das Digestsicherheitspaket nach bestimmten Attributen eines Sicherheitskontextsabzufragen.

Syntax

SECURITY_STATUS SEC_ENTRY QueryContextAttributes(
  _In_  PCtxtHandle phContext,
  _In_  ULONG       ulAttribute,
  _Out_ PVOID       pBuffer
);

Parameter

phContext [ In]

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

ulAttribute [ In]

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 _ AUTHORITY
6
Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext _ Authority-Struktur.
Fragt den Namen der authentifizierenden Autorität ab.
SECPKG _ VOM _ ATTR-CLIENT _ _ ANGEGEBENES ZIEL
27
Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext-ClientSpecifiedTarget-Struktur, _ die den Dienstprinzipalnamen (Service Principal Name, SPN) des vom Client bereitgestellten ursprünglichen Ziels darstellt.
Dieser Wert wird nur bei Verwendung von Kanalbindungen unterstützt.
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird nicht 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 gepackte KERB _ CERTIFICATE _ LOGON-Struktur.
Wenn es sich bei den Clientanmeldeinformationen um Onlineidentitätsanmeldeinformationen handelt, ist der Puffer eine gemarshallte 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-FLAGS
14
Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext-Flags-Struktur. _
Gibt Informationen zu den ausgehandelten Kontextflags zurück.
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 Sicherheitskontextverwendet werden.
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 _ CRED
Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext _ LocalCredentialInfo-Struktur. (Veraltet)
Ersetzt durch SECPKG _ ATTR _ LOCAL _ CERT _ CONTEXT.
SECPKG _ _ATTR-NAMEN
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 verwendet werden soll, und den aktuellen Status 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 _ 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-SITZUNGSSCHLÜSSEL
9
Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext _ SessionKey-Struktur.
Gibt Informationen zu den Sitzungsschlüsselnzurück.
SECPKG _ _ATTR-GRÖßEN
0
Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext _ Sizes-Struktur.
Fragt die Größen der Strukturen ab, die in den Funktionen pro Nachricht 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 Streams ab, die in den Funktionen pro Nachricht verwendet werden.
SECPKG _ _ATTR-ZIELINFORMATIONEN _
17
Der pBuffer-Parameter enthält einen Zeiger auf eine SecPkgContext-TargetInformation-Struktur. _
Gibt Informationen zum Namen des Remoteservers zurück.

pBuffer [ out]

Ein Zeiger auf eine -Struktur, die die Attribute empfängt. Der Typ der Struktur, auf die gezeigt wird, hängt vom im ulAttribute-Parameter angegebenen Wert ab.

Rückgabewert

Wenn die Funktion erfolgreich ist, lautet der Rückgabewert SEC _ E _ OK.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode ungleich 0 (null).

Bemerkungen

Die Struktur, auf die der pBuffer-Parameter zeigt, variiert abhängig vom abgefragten Attribut. Der Aufrufer muss die pBuffer-Struktur selbst zuordnen, aber der SSP belegt jeglichen Arbeitsspeicher, der zum Speichern von Membern variabler Größe der pBuffer-Struktur erforderlich ist. Der vom SSP belegte Arbeitsspeicher kann durch Aufrufen der FreeContextBuffer-Funktion freigegeben werden.

Nachdem der _ SECPKG ATTR _ REMOTE _ CERT _ CONTEXT- oder SECPKG _ ATTR LOCAL _ _ CERT _ CONTEXT-Wert gelesen wurde, wird das hCertStore-Element auf ein Handle für einen Zertifikatspeicher festgelegt, der ggf. die Zwischenzertifikate enthält. Außerdem ist die Anwendung für den Aufruf von CertFreeCertificateContext verantwortlich, um den vom Zertifikatkontext verwendeten Arbeitsspeicher freizugeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur XP-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Sspi.h (include Security.h)
Bibliothek
Secur32.lib
DLL
Secur32.dll
Unicode- und ANSI-Name
QueryContextAttributesW (Unicode) und QueryContextAttributesA (ANSI)

Weitere Informationen

SSPI-Funktionen

_CERT-KONTEXT

FreeContextBuffer

_SecPkgContext-Autorität

SecPkgContext _ ConnectionInfo

SecPkgContext _ DceInfo

SecPkgContext _ IssuerListInfoEx

SecPkgContext _ KeyInfo

SecPkgContext _ Lifespan

_SecPkgContext-Namen

_SecPkgContext-Größen

SecPkgContext _ StreamSizes