CPL_NEWINQUIRE сообщение

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

Параметры

uAppNum

Номер диалогового окна. Это число должно находиться в диапазоне от нуля до одного меньше значения, возвращаемого в ответ на сообщение CPL_GETCOUNT (CPL_GETCOUNT – 1).

lpncpli

Адрес структуры NEWCPLINFO . Приложение панель управления должно заполнить эту структуру сведениями о диалоговом окне.

Возвращаемое значение

Если функция CPlApplet успешно обрабатывает это сообщение, она должна вернуть ноль.

Комментарии

Для повышения производительности большинство приложений должны игнорировать CPL_NEWINQUIRE и обрабатывать сообщение CPL_INQUIRE .

Панель управления отправляет сообщение CPL_NEWINQUIRE один раз для каждого диалогового окна, поддерживаемого приложением. Панель управления также отправляет CPL_INQUIRE сообщение для каждого диалогового окна. Эти сообщения отправляются сразу после CPL_GETCOUNT сообщения. Однако система не гарантирует порядок отправки CPL_INQUIRE и CPL_NEWINQUIRE сообщений.

Вы можете выполнить инициализацию диалогового окна при получении CPL_INQUIRE. Если необходимо выделить память, сделайте это в ответ на сообщение CPL_INIT .

CPL_INQUIRE является предпочтительным сообщением. Это связано с тем , что CPL_NEWINQUIRE возвращает информацию в форме, которую система не может кэшировать. Следовательно, приложения, обрабатывающие CPL_NEWINQUIRE, должны загружаться каждый раз, когда панель управления требуется информация, что приводит к значительному снижению производительности.

Единственными приложениями, которые должны использовать CPL_NEWINQUIRE , являются приложения, которым необходимо изменять свои значки или отображать строки в зависимости от состояния компьютера. В этом случае обработчик CPL_INQUIRE должен указывать значение CPL_DYNAMIC_RES для элементов idIcon, idName или idInfo структуры CPLINFO , а не указывать допустимый идентификатор ресурса. Это приводит к тому, что панель управления будет отправлять CPL_NEWINQUIRE сообщение каждый раз, когда ему требуется значок и отображаемые строки, что позволяет указать сведения в зависимости от текущего состояния компьютера. Конечно, это значительно медленнее, чем использование кэшированных сведений.

Требования

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