ホーム › Security.WinWlx › PWLX_QUERY_TERMINAL_SERVICES_DATA

PWLX_QUERY_TERMINAL_SERVICES_DATA

コールバック

シグネチャ

DWORD PWLX_QUERY_TERMINAL_SERVICES_DATA(
    HANDLE hWlx,
    WLX_TERMINAL_SERVICES_DATA* pTSData,
    LPWSTR UserName,
    LPWSTR Domain
);

パラメーター

フィールド	型	説明
hWlx	HANDLE	WlxInitialize の呼び出しで GINA に渡された Winlogon ハンドルを指定します。
pTSData	WLX_TERMINAL_SERVICES_DATA*	ターミナルサービスに固有のユーザー構成情報を格納する構造体へのポインターです。
UserName	LPWSTR	新しくログオンしたユーザーの名前を指定する、null で終わるワイド文字列へのポインターです。
Domain	LPWSTR	新しくログオンしたユーザーのドメインを指定する、null で終わるワイド文字列へのポインターです。

公式ドキュメント

[WlxQueryTerminalServicesData 関数は、Windows Server 2008 および Windows Vista 以降では使用できません。]

ユーザーがログオンした後、ターミナルサービスのユーザー構成情報を取得するために GINA から呼び出されます。

メモ GINA DLL は Windows Vista では無視されます。

戻り値

WlxQueryTerminalServicesData 関数は、ユーザー構成情報の取得に成功した場合は 0 を返します。それ以外の場合は、エラーコードを返します。

解説(Remarks)

WlxQueryTerminalServicesData は、ユーザーが認証された後に、GINA が実装する WlxLoggedOutSAS の中から呼び出す必要があります。

この関数にアクセスするには、GINA DLL は WLX_DISPATCH_VERSION_1_3 構造体を使用し、 WlxNegotiate の呼び出しで Winlogon のバージョンを少なくとも WLX_VERSION_1_3 に設定する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)