Win32 API 日本語リファレンス
ホーム › UI.Controls › PFNDPAMERGE

PFNDPAMERGE

コールバック

シグネチャ

void* PFNDPAMERGE(
    DPAMM_MESSAGE uMsg,
    void* pvDest,
    void* pvSrc,
    LPARAM lParam
);

パラメーター

フィールド型説明
uMsgDPAMM_MESSAGE

マージをどのように処理するかをこの関数に指示するメッセージ。次のいずれかの値です。

値 意味
DPAMM_MERGE
0x1
 pvSrc を pvDest にマージする際に必要となる追加の処理を実行します。この関数は、マージ結果を格納した項目へのポインターを返す必要があります。マージ関数が返した値はマージ先に格納され、以前の値を上書きします。マージ関数が NULL を返した場合、マージ操作は中止されます。
DPAMM_DELETE
0x2
 マージの一部として削除が発生する際に必要となる追加の処理を実行します。この関数は NULL を返す必要があります。
DPAMM_INSERT
0x3
 マージの結果として項目が挿入される場合に、ユーザー定義の処理を実行します。この関数の戻り値は、マージの一部として挿入される項目の結果を指している必要があります。マージ関数が NULL を返した場合、マージ操作は中止されます。
pvDestvoid*マージにおける 1 番目の項目へのポインター。
pvSrcvoid*マージにおける 2 番目の項目へのポインター。
lParamLPARAMマージのコールバックで使用できる追加のデータ。

公式ドキュメント

DPA_Merge で使用されるマージ関数のプロトタイプを定義します。

戻り値

マージ結果の項目へのポインター。DPAMM_MERGE または DPAMM_INSERT が使用され、失敗した場合は NULL。

解説(Remarks)

このコールバック関数は、マージ操作の対象となる動的ポインター配列 (DPA) を変更してはなりません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)