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

こちらもご覧ください

CPLINFO