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

PROPSHEETUI_INFO 结构的 CPSUI 提供的大小(以字节为单位)。

Version

CPSUI 提供的 PROPSHEETUI_INFO 结构的版本号。 当前版本号由 compstui.h 中的 PROPSHEETUI_INFO_VERSION 定义。

Flags

CPSUI 提供的位标志。 定义了以下标志:

标志 描述
PSUIINFO_UNICODE 如果设置,调用应用程序将使用 Unicode 字符。

Reason

CPSUI 提供的常量,指定要由传递PROPSHEETUI_INFO结构的 PFNPROPSHEETUI 类型函数对属性表执行的操作。 将提供以下常量之一:

  • PROPSHEETUI_REASON_DESTROY

  • PROPSHEETUI_REASON_GET_ICON

  • PROPSHEETUI_REASON_GET_INFO_HEADER

  • PROPSHEETUI_REASON_INIT

  • PROPSHEETUI_REASON_SET_RESULT

有关每个常量的含义的信息,请参阅 PFNPROPSHEETUI 说明的“备注”部分。

hComPropSheet

属性表 组父级提供的 CPSUI 句柄。 此句柄可以传递给 CPSUI 的 ComPropSheet 函数。

pfnComPropSheet

CPSUI 的 ComPropSheet 函数的地址。

lParamInit

当第一次调用函数时,作为关联的 PFNPROPSHEETUI 类型函数的 lParam 参数接收的值, 其原因 为 PROPSHEETUI_REASON_INIT。 有关此值可以是什么的信息,请参阅 PFNPROPSHEETUI 的说明。

此值由 CPSUI 提供,对所有 Reason 值都有效。

UserData

可选的私有值或指针,由关联的 PFNPROPSHEETUI 类型函数提供,最初由 CPSUI 设置为零。 如果函数在 UserData 中存储值,则对于函数的后续调用,除非函数更改,否则存储的值或指针保持不变。

Result

由关联的 PFNPROPSHEETUI 类型函数提供的结果值,最初由 CPSUI 设置为零。 如果函数将结果值存储在 Result 中,则对于函数的后续调用,除非函数更改,否则存储的值将保持不变。

如果将 PFNPROPSHEETUI 类型函数的地址指定为 CommonPropertySheetUI 的参数,则存储在 Result 中的最后一个值将返回到其 pResult 参数指向的位置中的 CommonPropertySheetUI

要求

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