PWLX_DIALOG_BOX コールバック関数 (winwlx.h)
[WlxDialogBox 関数は、Windows Server 2008 および Windows Vista では使用できなくなりました。]
ダイアログ ボックス テンプレートからモーダル ダイアログ ボックスを作成するために 、GINA によって呼び出されます。
構文
PWLX_DIALOG_BOX PwlxDialogBox;
int PwlxDialogBox(
[in] HANDLE hWlx,
[in] HANDLE hInst,
[in] LPWSTR lpszTemplate,
[in] HWND hwndOwner,
[in] DLGPROC dlgprc
)
{...}
パラメーター
[in] hWlx
WlxInitialize 呼び出しで GINA に渡される Winlogon ハンドルを指定します。
[in] hInst
実行可能ファイルにダイアログ ボックス テンプレートが含まれているモジュールのインスタンスを指定します。
[in] lpszTemplate
ダイアログ ボックス テンプレートを指定します。 このパラメーターは、ダイアログ ボックス テンプレートの名前を指定する null で終わる文字列のアドレス、またはダイアログ ボックス テンプレートのリソース識別子を指定する整数値です。 このパラメーターにリソース識別子を指定する場合は、その上位ワードを 0 にして、下位ワードに識別子を含める必要があります。 この値は、MAKEINTRESOURCE マクロを使用して作成できます。
[in] hwndOwner
ダイアログ ボックスを所有するウィンドウを指定します。
[in] dlgprc
ダイアログ ボックス プロシージャをポイントします。 ダイアログ ボックス プロシージャの詳細については、 DialogProc コールバック関数に関するページを参照してください。
戻り値
WlxDialogBox 関数が成功した場合、戻り値は、ダイアログ ボックスを終了するために使用される EndDialog 関数の呼び出しで指定された nResult パラメーターです。 次の表に、成功の可能性のある戻り値をいくつか示します。
リターン コード | 説明 |
---|---|
|
入力がタイムアウトしました。 |
|
セキュア アテンション シーケンス (SAS) イベントが発生しました。 |
|
スクリーン セーバーがタイムアウトしました。 |
|
ユーザーがログオフしました。 |
関数が失敗した場合、戻り値は –1 になります。
注釈
GINA では、Windows DialogBox マクロではなく、Winlogon WlxDialogBox 関数を使用する必要があります。 WlxDialogBox は Windows DialogBox マクロを複製し、Winlogon でダイアログ ボックスを終了することもできます。 詳細については、「 DialogBox」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | winwlx.h |