通过

SETRESULT_INFO结构 （compstui.h）

  • 项目

SETRESULT_INFO 结构用作应用程序 PFNPROPSHEETUI类型回调函数的输入参数。

语法

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

成员

cbSize

SETRESULT_INFO 结构的 CPSUI 提供的大小（以字节为单位）。

wReserved

保留。

hSetResult

向从应用程序获取的已添加属性表页提供的 CPSUI 句柄。 有关详细信息，请参阅下面的 备注 部分。

Result

向从应用程序获取的已添加属性表页提供的 CPSUI 句柄。 有关详细信息，请参阅下面的 备注 部分。

言论

当应用程序调用 CPSUI 的 ComPropSheet 函数时，CPSUI 将调用所有已注册的 CPSFUNC_SET_RESULTPFNPROPSHEETUI类型函数，并指定PROPSHEETUI_REASON_SET_RESULT的原因。 指定此原因时，CPSUI 还提供 SETRESULT_INFO 结构。

结构 hSetResult 和 Result 成员中包含的值是分别提供给 CPSUI ComPropSheet 函数的 lParam1 和 lParam2 值。

每个应用程序的 PFNPROPSHEETUI 类型函数都按顺序调用，从最近声明的函数调用到声明的第一个函数，直到其中一个函数提供小于 1 的返回值。 此时，CPSUI 从其 ComPropSheet 函数返回，并提供调用的 PFNPROPSHEETUI 类型函数的数量计数。

通常，应用程序的 PFNPROPSHEETUI 类型函数将 Result 成员的PROPSHEETUI_INFO结构的成员设置为在 SETRESULT_INFO 结构的 Result 成员中接收的值。 然后，该函数返回一个值 1（或更大），因此下一个 PFNPROPSHEETUI 类型的函数也可以接收它。 每个随后调用的函数都与一个页面相关联，该页是与最后一个调用的函数关联的页面的父级。 函数可以修改 SETRESULT_INFO 结构的 Result 成员的内容，从而导致与父页关联的函数接收新值。

要求

要求 价值
标头 compstui.h （包括 Compstui.h）