PWLX_DIALOG_BOX

コールバック

シグネチャ

INT PWLX_DIALOG_BOX(
    HANDLE hWlx,
    HANDLE hInst,
    LPWSTR lpszTemplate,
    HWND hwndOwner,
    DLGPROC dlgprc
);

パラメーター

フィールド	型	説明
hWlx	HANDLE	GINA が WlxInitialize の呼び出しで受け取った Winlogon ハンドルを指定します。
hInst	HANDLE	ダイアログボックステンプレートを実行可能ファイル内に含むモジュールのインスタンスを指定します。
lpszTemplate	LPWSTR	ダイアログボックステンプレートを指定します。このパラメーターには、ダイアログボックステンプレートの名前を示す null で終わる文字列のアドレスか、ダイアログボックステンプレートのリソース識別子を示す整数値のいずれかを指定します。リソース識別子を指定する場合、上位ワードは 0 で、下位ワードに識別子を格納する必要があります。この値は MAKEINTRESOURCE マクロを使用して作成できます。
hwndOwner	HWND	ダイアログボックスを所有するウィンドウを指定します。
dlgprc	DLGPROC	ダイアログボックスプロシージャを指すポインターです。ダイアログボックスプロシージャの詳細については、 DialogProc コールバック関数を参照してください。

公式ドキュメント

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

ダイアログボックステンプレートからモーダルダイアログボックスを作成するために、GINA から呼び出されます。

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

戻り値

WlxDialogBox 関数が成功した場合、戻り値は、ダイアログボックスを終了するために使用した EndDialog 関数の呼び出しで指定された nResult パラメーターです。次の表に、成功時の戻り値の例を示します。

戻り値	説明
WLX_DLG_INPUT_TIMEOUT	入力がタイムアウトしました。
WLX_DLG_SAS	セキュリティで保護されたアテンションシーケンス (SAS) イベントが発生しました。
WLX_DLG_SCREEN_SAVER_TIMEOUT	スクリーンセーバーがタイムアウトしました。
WLX_DLG_USER_LOGOFF	ユーザーがログオフしました。

関数が失敗した場合、戻り値は –1 です。

解説(Remarks)

GINA は、Windows の DialogBox マクロではなく、Winlogon の WlxDialogBox 関数を使用する必要があります。WlxDialogBox は Windows の DialogBox マクロと同じ機能を提供し、さらに Winlogon がダイアログボックスを終了できるようにします。詳細については、 DialogBox を参照してください。

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