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 标头将 NEWCPLINFO 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	cpl.h

另请参阅

CPLINFO