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 |