WTSQueryUserToken-Funktion (wtsapi32.h)

Artikel
08/28/2023

Ruft das primäre Zugriffstoken des angemeldeten Benutzers ab, der durch die Sitzungs-ID angegeben ist. Damit diese Funktion erfolgreich aufgerufen werden kann, muss die aufrufende Anwendung im Kontext des LocalSystem-Kontos ausgeführt werden und über die berechtigung SE_TCB_NAME verfügen.

VorsichtWTSQueryUserToken ist für sehr vertrauenswürdige Dienste vorgesehen. Dienstanbieter müssen darauf achten, dass beim Aufrufen dieser Funktion keine Benutzertoken verloren gehen. Dienstanbieter müssen Tokenhandles schließen, nachdem sie sie verwendet haben.

Syntax

BOOL WTSQueryUserToken(
  [in]  ULONG   SessionId,
  [out] PHANDLE phToken
);

Parameter

[in] SessionId

Ein Remotedesktopdienste-Sitzungsbezeichner. Jedes Programm, das im Kontext eines Diensts ausgeführt wird, weist den Sitzungsbezeichner null (0) auf. Sie können die FUNKTION WTSEnumerateSessions verwenden, um die Bezeichner aller Sitzungen auf einem angegebenen RD-Sitzungshostserver abzurufen.

Um Informationen für die Sitzung eines anderen Benutzers abfragen zu können, benötigen Sie die Berechtigung Abfrageinformationen. Weitere Informationen finden Sie unter Berechtigungen für Remotedesktopdienste. Um Berechtigungen für eine Sitzung zu ändern, verwenden Sie das Verwaltungstool Remotedesktopdienstekonfiguration.

[out] phToken

Wenn die Funktion erfolgreich ist, empfängt einen Zeiger auf das Tokenhandle für den angemeldeten Benutzer. Beachten Sie, dass Sie die CloseHandle-Funktion aufrufen müssen, um dieses Handle zu schließen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein nonzero-Wert, und der phToken-Parameter verweist auf das primäre Token des Benutzers.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Informationen zu primären Token finden Sie unter Zugriffstoken. Weitere Informationen zu Kontoberechtigungen finden Sie unter Berechtigungen und Autorisierungskonstanten für Remotedesktopdienste.

Informationen zu den Berechtigungen, die diesem Konto zugeordnet sind, finden Sie unter LocalSystem-Konto .

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wtsapi32.h
Bibliothek	Wtsapi32.lib
DLL	Wtsapi32.dll
APIs	ext-ms-win-session-wtsapi32-l1-1-0 (in Windows 8 eingeführt)

Weitere Informationen

CloseHandle

WTSEnumerateSessions

Freigeben über