NEWCPLINFOA 構造体 (cpl.h)
コントロール パネル アプリケーションでサポートされているダイアログ ボックスのリソース情報とアプリケーション定義値が含まれます。
構文
typedef struct tagNEWCPLINFOA {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHelpContext;
LONG_PTR lData;
HICON hIcon;
CHAR szName[32];
CHAR szInfo[64];
CHAR szHelpFile[128];
} NEWCPLINFOA, *LPNEWCPLINFOA;
メンバー
dwSize
型: DWORD
構造体の長さ (バイト単位)。
dwFlags
型: DWORD
このメンバーは無視されます。
dwHelpContext
型: DWORD
このメンバーは無視されます。
lData
種類: LONG_PTR
アプリケーションによって定義されたデータへのポインター。 コントロール パネルがCPL_DBLCLKを送信し、メッセージをCPL_STOPすると、この値がアプリケーションに返されます。
hIcon
種類: HICON
ダイアログ ボックスを表すアイコンの識別子。 このアイコンは、コントロール パネル アプリケーションを制御するアプリケーションによって表示されることを目的としています。
szName[32]
種類: TCHAR[32]
ダイアログ ボックス名を含む null で終わる文字列。 名前は、アイコンの下に表示されることを意図しています。
szInfo[64]
種類: TCHAR[64]
ダイアログ ボックスの説明を含む null で終わる文字列。 説明は、ダイアログ ボックスのアイコンが選択されたときに表示されることを目的としています。
szHelpFile[128]
種類: TCHAR[128]
このメンバーは無視されます。
注釈
コントロール パネル アプリケーションの CPlApplet 関数は、CPL_NEWINQUIRE メッセージに応答してこの情報をコントロール パネルに返します。
注意
cpl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして NEWCPLINFO を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | cpl.h |