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)

此頁面對您有幫助嗎？