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

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

  • Статья

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

Синтаксис

typedef struct _SETRESULT_INFO {
  WORD    cbSize;
  WORD    wReserved;
  HANDLE  hSetResult;
  LRESULT Result;
} SETRESULT_INFO, *PSETRESULT_INFO;

Члены

cbSize

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

wReserved

Зарезервировано.

hSetResult

Предоставленный CPSUI дескриптор для страницы страницы добавленных свойств, полученной из приложения. Дополнительные сведения см. в разделе Примечания ниже.

Result

Предоставленный CPSUI дескриптор для страницы страницы добавленных свойств, полученной из приложения. Дополнительные сведения см. в разделе Примечания ниже.

Комментарии

Когда приложение вызывает функцию COMPropSheet CPSUI, указывая код функции CPSFUNC_SET_RESULT, CPSUI вызывает все зарегистрированные функции типа PFNPROPSHEETUI, указывая причину PROPSHEETUI_REASON_SET_RESULT. При указании этой причины CPSUI также предоставляет SETRESULT_INFO структуру.

Значения, содержащиеся в элементах hSetResult и Result структуры, являются значениями lParam1 и lParam2 соответственно, которые были переданы функции ComPropSheet CPSUI.

Каждая из функций приложения с типом PFNPROPSHEETUI вызывается в порядке от последней объявленной до первой объявленной, пока одна из этих функций не предоставит возвращаемое значение меньше единицы. На этом этапе CPSUI возвращает из своей функции ComPropSheet , предоставляя количество вызываемых функций типа PFNPROPSHEETUI.

Как правило, функция приложения с типом PFNPROPSHEETUI задает для элемента Result своей структуры PROPSHEETUI_INFO значение, полученное в элементе Result структуры SETRESULT_INFO. Затем функция возвращает значение 1 (или больше), поэтому следующая функция PFNPROPSHEETUI также может получить его. Каждая впоследствии вызываемая функция связана со страницей, которая является родительской для страницы, связанной с последней вызываемой функцией. Функция может изменять содержимое элемента Result структуры SETRESULT_INFO, что приводит к тому, что функции, связанные с родительскими страницами, получают новое значение.

Требования

Требование Значение
Заголовок compstui.h (включая Compstui.h)