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

  • [アーティクル]

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

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

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

構文

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 パラメーターです。 次の表に、成功の可能性のある戻り値をいくつか示します。

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

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

注釈

GINA では、Windows DialogBox マクロではなく、Winlogon WlxDialogBox 関数を使用する必要があります。 WlxDialogBox は Windows DialogBox マクロを複製し、Winlogon でダイアログ ボックスを終了することもできます。 詳細については、「 DialogBox」を参照してください。

要件

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

こちらもご覧ください

ダイアログ

DialogProc

EndDialog

MAKEINTRESOURCE

WlxInitialize