Share via

Структура 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 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

См. также раздел

CPLINFO