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

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

Flags

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

描述
PSUIINFO_UNICODE 如果已设置,调用应用程序将使用 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 句柄 组父。 此句柄可以传递给 CPSUI 的 ComPropSheet 函数。

pfnComPropSheet

CPSUI 的 ComPropSheet 函数的地址。

lParamInit

当首次使用PROPSHEETUI_REASON_INIT的 Reason 调用函数时,作为关联的 PFNPROPSHEETUI 类型函数的 lParam 参数接收的值。 有关此值的内容的信息,请参阅 PFNPROPSHEETUI的说明。

此值由 CPSUI 提供,对所有 原因 值有效。

UserData

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

Result

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

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

要求

要求 价值
标头 compstui.h (包括 Compstui.h)