LPFNPSPCALLBACKW コールバック関数 (prsht.h)

  • [アーティクル]

ページが作成され、破棄されるときにプロパティ シートが呼び出すアプリケーション定義のコールバック関数を指定します。 アプリケーションはこの関数を使用して、ページの初期化およびクリーンアップ操作を実行できます。

構文

LPFNPSPCALLBACKW Lpfnpspcallbackw;

UINT Lpfnpspcallbackw(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEW *ppsp
)
{...}

パラメーター

hwnd

種類: HWND

予約; は NULL である必要があります。

[in] uMsg

型: UINT

アクション フラグ。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
PSPCB_ADDREF

バージョン 5.80 以降。 ページが作成されています。 戻り値は使用されません。
PSPCB_CREATE
 ページのダイアログ ボックスが作成されています。 0 以外の値を返して作成を許可します。作成できないようにするには 0 を返します。
PSPCB_RELEASE
 ページが破棄されています。 戻り値は無視されます。

[in, out] ppsp

種類: LPPROPSHEETPAGE

作成または破棄されるページを定義する PROPSHEETPAGE 構造体へのポインター。 詳細については、「解説」セクションを参照してください。

戻り値

型: UINT

戻り値は 、uMsg パラメーターの値によって異なります。

注釈

アプリケーションは、構造体を CreatePropertySheetPage 関数に渡す前に、PROPSHEETPAGE 構造体の pfnCallback メンバーでこのコールバック関数のアドレスを指定する必要があります。

メモ プロパティ シートは、この関数が呼び出されたときにページの一覧を操作する処理中です。 この通知の処理中に、ページの追加、削除、挿入を試みないでください。 これにより、予期しない結果が得られます。
 
lParam メンバーを除き、アプリケーションは PROPSHEETPAGE 構造体を変更しないでください。 これにより、予期しない結果が得られます。 lParam メンバーにはアプリケーション定義データが含まれており、必要に応じて変更できます。

注意

prsht.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LPFNPSPCALLBACK を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー prsht.h