次の方法で共有

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 型の各関数は、最後に宣言されたものから宣言された最初の関数まで、これらの関数の 1 つが 1 未満の戻り値を提供するまで順番に呼び出されます。 その時点で、CPSUI は ComPropSheet 関数から戻り、呼び出された PFNPROPSHEETUI 型の関数の数を指定します。

通常、アプリケーションの PFNPROPSHEETUI 型の関数は、PROPSHEETUI_INFO構造体の Result メンバーを、SETRESULT_INFO 構造体の Result メンバーで受け取った値に設定します。 次に、この関数は 1 (以上) の値を返します。そのため、次の PFNPROPSHEETUI 型の関数も受け取ることができます。 その後呼び出される各関数は、最後に呼び出された関数に関連付けられたページの親であるページに関連付けられます。 関数は、SETRESULT_INFO 構造体の Result メンバーの内容を変更でき、親ページに関連付けられている関数は新しい値を受け取ります。

必要条件

要件 価値
ヘッダー compstui.h (Compstui.h を含む)