Поделиться через

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
заголовка cpl.h

См. также

CPLINFO