PWLX_QUERY_TERMINAL_SERVICES_DATA回呼函式 (winwlx.h)

發行項
03/04/2024

[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