共用方式為

SETRESULT_INFO結構 （compstui.h）

  • 發行項

SETRESULT_INFO 結構會作為應用程式 PFNPROPSHEETUI型別回呼函式的輸入參數。

語法

typedef struct _SETRESULT_INFO {
  WORD    cbSize;
  WORD    wReserved;
  HANDLE  hSetResult;
  LRESULT Result;
} SETRESULT_INFO, *PSETRESULT_INFO;

成員

cbSize

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

wReserved

保留。

hSetResult

CPSUI 提供的句柄至從應用程式取得的已新增屬性表頁面。 如需詳細資訊，請參閱下方的<<備註> 一節。

Result

CPSUI 提供的句柄至從應用程式取得的已新增屬性表頁面。 如需詳細資訊，請參閱下方的<<備註> 一節。

言論

當應用程式呼叫 CPSUI 的 ComPropSheet 函式時，指定 CPSFUNC_SET_RESULT的函式程式代碼，CPSUI 會呼叫所有 已註冊的 PFNPROPSHEETUI型別函式，並指定PROPSHEETUI_REASON_SET_RESULT的原因。 指定這個原因時，CPSUI 也會提供 SETRESULT_INFO 結構。

結構 hSetResult 和 Result 成員中包含的值分別是 lParam1 和 lParam2 值，分別提供給 CPSUI ComPropSheet 函式。

每個應用程式的 PFNPROPSHEETUI 型別函式都會依序呼叫，從最近宣告的函式呼叫為宣告的第一個函式，直到其中一個函式提供小於一個的傳回值。 此時，CPSUI 會從其 ComPropSheet 函式傳回，並提供呼叫的 PFNPROPSHEETUI 型別函式數目計數。

一般而言，應用程式的 PFNPROPSHEETUI 型別函式會將 Result 成員的PROPSHEETUI_INFO結構成員設定為 SETRESULT_INFO 結構 Result 成員中所收到的值。 然後函式會傳回值 1（或更新），因此下一個 PFNPROPSHEETUI 型別函式也可以接收它。 每個後續呼叫的函式都會與頁面相關聯，該頁面是與最後一個呼叫函式相關聯的頁面父系。 函式可以修改 SETRESULT_INFO 結構 Result 成員的內容，導致與父頁面相關聯的函式接收新值。

要求

要求 價值
標頭 compstui.h （包括 Compstui.h）