QuerySecurityContextToken-Funktion (sspi.h)

Ruft das Zugriffstoken für einen Clientsicherheitskontext ab und verwendet es direkt.

Syntax

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY QuerySecurityContextToken(
  [in]  PCtxtHandle phContext,
  [out] void        **Token
);

Parameter

[in] phContext

Handle des abzufragenden Kontexts.

[out] Token

Das Handle wurde an das Zugriffstoken zurückgegeben.

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. Eine mögliche Fehlercoderückgabe ist SEC_E_INVALID_HANDLE.

Hinweise

Diese Funktion wird von einer Serveranwendung aufgerufen, um den Identitätswechsel außerhalb der SSPI-Ebene zu steuern, z. B. beim Starten eines untergeordneten Prozesses. Das zurückgegebene Handle muss mit CloseHandle geschlossen werden, wenn das Handle nicht mehr benötigt wird.

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

Weitere Informationen

CloseHandle

SSPI-Funktionen