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