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

CPSUI 提供的大小，以位元組為單位，PROPSHEETUI_INFO 結構。

Version

CPSUI 提供的 PROPSHEETUI_INFO 結構版本號碼。 目前的版本號碼是由 compstui.h 中的 PROPSHEETUI_INFO_VERSION 所定義。

Flags

CPSUI 提供的位旗標。 定義下列旗標：

Reason

CPSUI 提供的常數，指定要在屬性表上執行的動作，由 PFNPROPSHEETUI-typed 函式傳遞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

當函式第一次以 Reason 呼叫時，收到做為相關聯 PFNPROPSHEETUI 型別函式的 lParam PROPSHEETUI_REASON_INIT 參數的值。 如需此值之內容的詳細資訊，請參閱 PFNPROPSHEETUI的描述。

這個值是由 CPSUI 提供，而且適用於所有 Reason 值。

UserData

由相關聯的 PFNPROPSHEETUI型別函式提供的選擇性、私用值或指標，一開始由 CPSUI 設定為零。 如果函式將值儲存在 UserData中，則對於函式的後續呼叫，除非函式變更，否則預存的值或指標不會變更。

Result

由相關聯 PFNPROPSHEETUI型別函式提供的結果值，一開始由 CPSUI 設定為零。 如果函式將結果值儲存在 Result中，則除非函式變更，否則除非函式變更，否則會變更預存值。

如果 PFNPROPSHEETUI 類型函式的位址指定為 commonPropertySheetUI 的自變數，則會將儲存 Result 中的最後一個值傳回至其 pResult 自變數所指向位置 CommonPropertySheetUI。

要求