структура PROPSHEETUI_INFO (compstui.h)

Структура PROPSHEETUI_INFO используется в качестве входного параметра для -типизированных функций PFNPROPSHEETUI.

Синтаксис

typedef struct _PROPSHEETUI_INFO {
  WORD            cbSize;
  WORD            Version;
  WORD            Flags;
  WORD            Reason;
  HANDLE          hComPropSheet;
  PFNCOMPROPSHEET pfnComPropSheet;
  LPARAM          lParamInit;
  ULONG_PTR       UserData;
  ULONG_PTR       Result;
} PROPSHEETUI_INFO, *PPROPSHEETUI_INFO;

Члены

cbSize

Предоставленный cpSUI размер в байтах PROPSHEETUI_INFO структуры.

Version

Номер версии, предоставленной CPSUI, PROPSHEETUI_INFO структуры. Текущий номер версии определяется PROPSHEETUI_INFO_VERSION в compstui.h.

Flags

Флаги битов, предоставленные CPSUI. Определен следующий флаг:

Флаг	Описание
PSUIINFO_UNICODE	Если задано, вызывающее приложение использует символы Юникода.

Reason

Константа CPSUI, указывающая действие, выполняемое на листе свойств, PFNPROPSHEETUIтипизированной функции, в которую была передана структура PROPSHEETUI_INFO. Будет предоставлена одна из следующих констант:

• PROPSHEETUI_REASON_DESTROY

• PROPSHEETUI_REASON_GET_ICON

• PROPSHEETUI_REASON_GET_INFO_HEADER

• PROPSHEETUI_REASON_INIT

• PROPSHEETUI_REASON_SET_RESULT

Сведения о значении каждой константы см. в разделе "Примечания" описания PFNPROPSHEETUI.

hComPropSheet

Предоставленный обработчик CPSUI для листа свойств родительскойгруппы. Этот дескриптор можно передать в функцию ComPropSheet CPSUI.

pfnComPropSheet

Адрес функции comPropSheet CPSUI.

lParamInit

Значение, полученное в качестве параметра lParam для связанной функции типа PFNPROPSHEETUI, при первом вызове функции с Причина PROPSHEETUI_REASON_INIT. Сведения об этом значении см. в описании PFNPROPSHEETUI.

Это значение предоставляется CPSUI и допустимо для всех значений Reason.

UserData

Необязательное, частное значение или указатель, предоставленные связанной PFNPROPSHEETUI-typed function, изначально задается равным нулю по CPSUI. Если функция сохраняет значение в UserData, то для последующих вызовов функции хранимое значение или указатель не изменяется, если функция не изменилась.

Result

Значение результата, предоставленное связанной PFNPROPSHEETUIтипизированной функцией, изначально задается равным нулю cpSUI. Если функция сохраняет значение результата в результирующих, то для последующих вызовов функции хранимое значение не изменяется, если функция не изменится.

Если адрес функции типа PFNPROPSHEETUI был указан в качестве аргумента для CommonPropertySheetUI, последнее значение, хранящееся в Result, возвращается в CommonPropertySheetUI в расположении, на которое указывает его аргумент pResult.

Требования

Требование	Ценность
заголовка	compstui.h (include Compstui.h)