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 提供的位旗標。 定義下列旗標：

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

當第一次使用PROPSHEETUI_REASON_INIT原因呼叫函式時，接收為相關聯 PFNPROPSHEETUI 型別函式的 lParam 參數的值。 如需此值可做為哪些資訊，請參閱 PFNPROPSHEETUI 的描述。

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

UserData

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

Result

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

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

規格需求