WTSQueryUserToken 函式 (wtsapi32.h)
取得會話識別碼所指定登入使用者的主要存取權杖。 若要成功呼叫此函式，呼叫的應用程式必須在 LocalSystem 帳戶 的內容中執行，並具有 SE_TCB_NAME 許可權。
注意WTSQueryUserToken 適用于高度信任的服務。 服務提供者在呼叫此函式時，必須注意它們不會洩漏使用者權杖。 服務提供者在使用權杖之後必須關閉權杖控制碼。
語法
BOOL WTSQueryUserToken(
[in] ULONG SessionId,
[out] PHANDLE phToken
);
參數
[in] SessionId
遠端桌面服務會話識別碼。 在服務內容中執行的任何程式，會話識別碼為零， (0) 。 您可以使用 WTSEnumerateSessions 函式來擷取指定 RD 工作階段主機伺服器上所有會話的識別碼。
若要能夠查詢其他使用者會話的資訊，您必須擁有查詢資訊許可權。 如需詳細資訊，請參閱 遠端桌面服務許可權。 若要修改會話的許可權，請使用遠端桌面服務組態系統管理工具。
[out] phToken
如果函式成功，則會收到登入使用者的權杖控制碼指標。 請注意，您必須呼叫 CloseHandle 函式以關閉此控制碼。
傳回值
如果函式成功，則傳回值為非零值， 而 phToken 參數會指向使用者的主要權杖。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
如需主要權杖的相關資訊，請參閱 存取權杖。 如需帳戶許可權的詳細資訊，請參閱 遠端桌面服務許可權 和 授權常數。
如需與該帳戶相關聯的許可權相關資訊，請參閱 LocalSystem 帳戶 。
規格需求
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | wtsapi32.h |
| 程式庫 | Wtsapi32.lib |
| Dll | Wtsapi32.dll |
| API 集合 | ext-ms-win-session-wtsapi32-l1-1-0 (在 Windows 8) |