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 函数，将函数代码指定 为 CPSFUNC_SET_RESULT 时，CPSUI 会调用所有已注册的 PFNPROPSHEETUI 类型函数，并指定PROPSHEETUI_REASON_SET_RESULT的原因。 指定此原因时，CPSUI 还提供 SETRESULT_INFO 结构。

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

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

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

要求

要求	值
Header	compstui.h (包括 Compstui.h)