PWLX_DIALOG_BOX_PARAM コールバック関数 (winwlx.h)

  • [アーティクル]

[WlxDialogBoxParam 関数は、Windows Server 2008 および Windows Vista では使用できなくなりました。

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

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

構文

PWLX_DIALOG_BOX_PARAM PwlxDialogBoxParam;

int PwlxDialogBoxParam(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPWSTR lpszTemplate,
  [in] HWND hwndOwner,
  [in] DLGPROC dlgprc,
  [in] LPARAM dwInitParam
)
{...}

パラメーター

[in] hWlx

WlxInitialize 呼び出しで GINA に渡される Winlogon ハンドルを指定します。

[in] hInst

実行可能ファイルにダイアログ ボックス テンプレートが含まれているモジュールのインスタンスを指定します。

[in] lpszTemplate

ダイアログ ボックス テンプレートを指定します。 このパラメーターは、ダイアログ ボックス テンプレートの名前を指定する null で終わる文字列のアドレス、またはダイアログ ボックス テンプレートのリソース識別子を指定する整数値です。 このパラメーターにリソース識別子を指定する場合は、その上位ワードを 0 にして、下位ワードに識別子を含める必要があります。 この値は、MAKEINTRESOURCE マクロを使用して作成できます。

[in] hwndOwner

ダイアログ ボックスを所有するウィンドウを指定します。

[in] dlgprc

ダイアログ ボックス プロシージャをポイントします。 ダイアログ ボックス プロシージャの詳細については、DialogProc に関するページをご覧ください。

[in] dwInitParam

WM_INITDIALOG メッセージの lParam パラメーターでダイアログ ボックスに渡す値を指定します。

戻り値

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

リターン コード 説明
WLX_DLG_INPUT_TIMEOUT
 入力がタイムアウトしました。
WLX_DLG_SAS
 Secure Attention Sequence (SAS) イベントが発生しました。
WLX_DLG_SCREEN_SAVER_TIMEOUT
 スクリーン セーバーがタイムアウトしました。
WLX_DLG_USER_LOGOFF
 ユーザーがログオフしました。
 

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

注釈

WlxDialogBoxParam は Windows DialogBoxParam 関数を複製し、Winlogon でダイアログ ボックスを終了することもできます。 詳細については、「 DialogBoxParam」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winwlx.h

こちらもご覧ください

DialogBoxParam

DialogProc

EndDialog

MAKEINTRESOURCE

WlxInitialize