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 提供のビット フラグ。 次のフラグが定義されています。

フラグ	説明
PSUIINFO_UNICODE	設定されている場合、呼び出し元のアプリケーションは Unicode 文字を使用します。

Reason

PROPSHEETUI_INFO構造体が渡された PFNPROPSHEETUI 型関数によってプロパティ シートに対して実行されるアクションを指定する CPSUI 指定の定数。 次のいずれかの定数が指定されます。

• 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

関連付けられた PFNPROPSHEETUI 型の関数の lParam パラメーターとして受け取った値。関数が最初に Reason of PROPSHEETUI_REASON_INITで呼び出されたとき。 この値の詳細については、 PFNPROPSHEETUI の説明を参照してください。

この値は CPSUI によって提供され、すべての 理由 値に対して有効です。

UserData

関連付けられた PFNPROPSHEETUI 型の関数によって提供される省略可能なプライベート値またはポインター。最初は CPSUI によってゼロに設定されます。 関数が UserData に値を格納する場合、その後の関数の呼び出しでは、関数によって変更されない限り、格納された値またはポインターは変更されません。

Result

関連付けられた PFNPROPSHEETUI 型の関数によって提供される結果値。最初は CPSUI によって 0 に設定されます。 関数が Result に結果値を格納する場合、その後の関数の呼び出しでは、関数によって変更されない限り、格納された値は変更されません。

PFNPROPSHEETUI 型の関数のアドレスが CommonPropertySheetUI の引数として指定されている場合、Result に格納されている最後の値は、pResult 引数が指す場所の CommonPropertySheetUI に返されます。

要件

要件	値
Header	compstui.h (Compstui.h を含む)