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 [デスクトップ アプリのみ]
ヘッダー	cpl.h

関連項目

CPLINFO