SETRESULT_INFO結構 (compstui.h)

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

語法

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

成員

cbSize

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

wReserved

保留的。

hSetResult

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

Result

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

備註

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

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

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

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

規格需求

需求	值
標頭	compstui.h (包含 Compstui.h)