CPLINFO 结构 (cpl.h)

包含控制面板应用程序支持的对话框的资源信息和应用程序定义的值。 控制面板应用程序的 CPlApplet 函数将此信息返回给控制面板，以响应CPL_INQUIRE消息。

语法

typedef struct tagCPLINFO {
  int      idIcon;
  int      idName;
  int      idInfo;
  LONG_PTR lData;
} CPLINFO, *LPCPLINFO;

成员

idIcon

类型： int

表示对话框的图标的资源标识符。

idName

类型： int

包含对话框短名称的字符串的资源标识符。 此名称应显示在图标下方。

idInfo

类型： int

字符串的资源标识符，其中包含要在选择应用程序图标时显示的对话框的说明。

lData

类型： LONG_PTR

指向应用程序定义的数据的指针。 当控制面板发送CPL_DBLCLK并CPL_STOP消息时，它会将此值传递回应用程序。

备注

如果对话框的图标或显示字符串可以根据计算机的状态更改，则可以指定 idIcon、 idName 或 idInfo 成员的CPL_DYNAMIC_RES值，而不是指定有效的资源标识符。 这会导致控制面板在每次需要图标和显示字符串时发送CPL_NEWINQUIRE消息。 但是，使用此方法的速度要慢一些，因为每次发送CPL_NEWINQUIRE消息时，控制面板都需要加载应用程序。

要求

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