CPL_INQUIRE メッセージ

アプリケーションがサポートするダイアログ ボックスに関する情報を要求するために、コントロール パネル アプリケーションの CPlApplet 関数に送信されます。

パラメーター

uAppNum

ダイアログ ボックス番号。 この数値は、CPL_GETCOUNT メッセージ ( CPL_GETCOUNT - 1) に応答して返される値より 1 未満の範囲である必要があります。

lpcpli

CPLINFO 構造体のアドレス。 アプリケーションは、アイコン、短い名前、説明、およびダイアログ ボックスに関連付けられているユーザー定義値のリソース識別子をこの構造体に入力する必要があります。

戻り値

CPlApplet 関数がこのメッセージを正常に処理すると、0 が返されます。

解説

コントロール パネルは、アプリケーションでサポートされているダイアログ ボックスごとに、CPL_INQUIRE メッセージを 1 回送信します。 コントロール パネルは、ダイアログ ボックスごとにCPL_NEWINQUIRE メッセージも送信します。 これらのメッセージは、CPL_GETCOUNT メッセージの直後 に 送信されます。 ただし、システムは、 CPL_INQUIRE メッセージと CPL_NEWINQUIRE メッセージが送信される順序を保証しません。

ダイアログ ボックスの初期化は、 CPL_INQUIREを受け取ったときに実行できます。 メモリを割り当てる必要がある場合は、 CPL_INIT メッセージに応答して割り当てます。

CPL_NEWINQUIRE メッセージは、システムがキャッシュできない形式の情報を返します。 このため、ほとんどの CPlApplet 関数では 、CPL_INQUIRE を処理し、CPL_NEWINQUIREを無視 する必要があります。

CPL_NEWINQUIREを使用する必要があるアプリケーションは、コンピューターの状態に基づいてアイコンを変更したり、文字列を表示したりする必要があるアプリケーションだけです。 この場合、CPL_INQUIRE ハンドラーでは、有効なリソース識別子を指定するのではなく、CPLINFO 構造体の idIcon、idName、または idInfo メンバーのCPL_DYNAMIC_RES値を指定する必要があります。 これにより、コントロール パネルはアイコンと表示文字列が必要なたびにCPL_NEWINQUIRE メッセージを送信し、コンピューターの現在の状態に基づいて情報を指定できます。 これは、キャッシュされた情報を使用する場合よりも大幅に遅くなります。

必要条件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	Cpl.h