CPL_INQUIRE消息

  • 项目

发送到控制面板应用程序的 CPlApplet 函数，以请求有关应用程序支持的对话框的信息。

parameters

uAppNum

对话框编号。 此数字的范围必须小于响应 CPL_GETCOUNT 消息 (CPL_GETCOUNT 1) 返回的值 0 到 1。

lpcpli

CPLINFO 结构的地址。 应用程序必须使用图标的资源标识符、短名称、说明以及与对话框关联的任何用户定义的值填充此结构。

返回值

如果 CPlApplet 函数成功处理此消息，则它应返回零。

备注

控制面板为应用程序支持的每个对话框发送一次CPL_INQUIRE消息。 控制面板还会为每个对话框发送CPL_NEWINQUIRE消息。 这些消息在 CPL_GETCOUNT 消息之后立即发送。 但是，系统不保证 发送CPL_INQUIRE 和 CPL_NEWINQUIRE 消息的顺序。

收到 CPL_INQUIRE时，可以对对话框执行初始化。 如果必须分配内存，则这样做以响应 CPL_INIT 消息。

CPL_NEWINQUIRE消息以系统无法缓存的形式返回信息。 因此，大多数 CPlApplet 函数应处理 CPL_INQUIRE 并忽略 CPL_NEWINQUIRE。

应使用 CPL_NEWINQUIRE 的唯一应用程序是那些需要根据计算机状态更改其图标或显示字符串的应用程序。 在这种情况下，CPL_INQUIRE处理程序应为 CPLINFO 结构的 idIcon、idName 或 idInfo 成员指定CPL_DYNAMIC_RES值，而不是指定有效的资源标识符。 这会导致控制面板在每次需要图标和显示字符串时发送CPL_NEWINQUIRE消息，从而可以根据计算机的当前状态指定信息。 这比使用缓存信息慢得多。

要求

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