Win32 API 日本語リファレンス
ホーム › Security.WinWlx › PWLX_DIALOG_BOX_PARAM

PWLX_DIALOG_BOX_PARAM

コールバック

シグネチャ

INT PWLX_DIALOG_BOX_PARAM(
    HANDLE hWlx,
    HANDLE hInst,
    LPWSTR lpszTemplate,
    HWND hwndOwner,
    DLGPROC dlgprc,
    LPARAM dwInitParam
);

パラメーター

フィールド型説明
hWlxHANDLEWlxInitialize の呼び出しで GINA に渡された Winlogon ハンドルを指定します。
hInstHANDLEダイアログボックステンプレートを含む実行可能ファイルを持つモジュールのインスタンスを指定します。
lpszTemplateLPWSTRダイアログボックステンプレートを指定します。このパラメーターは、ダイアログボックステンプレートの名前を指定する null 終端文字列のアドレスか、ダイアログボックステンプレートのリソース識別子を指定する整数値のいずれかです。リソース識別子を指定する場合は、上位ワードが 0 で、下位ワードに識別子が格納されている必要があります。この値の作成には MAKEINTRESOURCE マクロを使用できます。
hwndOwnerHWNDダイアログボックスを所有するウィンドウを指定します。
dlgprcDLGPROCダイアログボックスプロシージャを指します。ダイアログボックスプロシージャの詳細については、 DialogProc を参照してください。
dwInitParamLPARAMWM_INITDIALOG メッセージの lParam パラメーターでダイアログボックスに渡す値を指定します。

公式ドキュメント

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

GINA によって呼び出され、ダイアログボックスのコントロールを初期化したうえで、ダイアログボックステンプレートリソースからモーダルダイアログボックスを作成します。

注意 GINA DLL は Windows Vista では無視されます。

戻り値

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

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

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

解説(Remarks)

WlxDialogBoxParam は Windows の DialogBoxParam 関数と同じ機能を提供し、さらに Winlogon がダイアログボックスを終了できるようにします。詳細については、 DialogBoxParam を参照してください。

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