PWLX_QUERY_TERMINAL_SERVICES_DATA回呼函式 (winwlx.h)
[WlxQueryTerminalServicesData 函式已不再可供 Windows Server 2008 和 Windows Vista 使用。]
由 GINA 呼叫,以在使用者登入之後擷取終端機服務用戶設定資訊。
注意 Windows Vista 中會忽略 GINA DLL。
語法
PWLX_QUERY_TERMINAL_SERVICES_DATA PwlxQueryTerminalServicesData;
DWORD PwlxQueryTerminalServicesData(
[in] HANDLE hWlx,
[out] PWLX_TERMINAL_SERVICES_DATA pTSData,
[in] WCHAR *UserName,
[in] WCHAR *Domain
)
{...}
參數
[in] hWlx
指定在 WlxInitialize 呼叫中傳遞至 GINA 的 Winlogon 句柄。
[out] pTSData
指向結構,其中包含終端機服務特定的使用者設定資訊。
[in] UserName
Null 終止寬字元字串的指標,指定新登入用戶的名稱。
[in] Domain
指定新登入使用者網域之 Null 終止寬字元字串的指標。
傳回值
如果成功擷取使用者設定資訊, WlxQueryTerminalServicesData 函式會傳回零。 否則,它會傳回錯誤碼。
備註
在使用者通過驗證之後,應該從 GINA 的 WlxLoggedOutSAS 實作中呼叫 WlxQueryTerminalServicesData。
若要存取此函式,GINA DLL 必須使用 WLX_DISPATCH_VERSION_1_3 結構,並將 Winlogon 版本設定為其 WlxNegotiate 呼叫中至少WLX_VERSION_1_3。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | winwlx.h |