CPL_INQUIRE сообщение

Отправляется в функцию CPlApplet приложения панель управления для запроса сведений о диалоговом окне, которое поддерживает приложение.

Параметры

uAppNum

Номер диалогового окна. Это число должно находиться в диапазоне от нуля до одного меньше значения, возвращаемого в ответ на сообщение CPL_GETCOUNT (CPL_GETCOUNT – 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 должен указывать значение CPL_DYNAMIC_RES для элементов idIcon, idName или idInfo структуры CPLINFO , а не указывать допустимый идентификатор ресурса. Это приводит к тому, что панель управления будет отправлять CPL_NEWINQUIRE сообщение каждый раз, когда ему требуется значок и отображаемые строки, что позволяет указать сведения в зависимости от текущего состояния компьютера. Это значительно медленнее, чем использование кэшированных сведений.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Cpl.h