Share via

DPA_SortedInsertPtr マクロ (dpa_dsa.h)

  • [アーティクル]

指定した既存の項目の前または後に新しい項目を挿入します。

構文

void DPA_SortedInsertPtr(
   hdpa,
   pFind,
   iStart,
   pfnCompare,
   lParam,
   options,
   pitem
);

パラメーター

hdpa

種類: HDPA

DPA へのハンドル。

pFind

型: void*

新しい項目の挿入ポイントを決定するために使用される項目ポインター (「解説」を参照)。

iStart

型: int

pFind の検索を開始する DPA 内のインデックス。

pfnCompare

型: PFNDPACOMPARE

比較関数へのポインター。 比較関数プロトタイプについては、 PFNDPACOMPARE または PFNDPACOMPARECONST を参照してください。

lParam

種類: LPARAM

pfnCmp が指す比較関数に情報を渡すために使用される追加のパラメーター。

options

型: UINT

挿入ポイント。 次のいずれかの値を指定する必要があります。

値 意味
DPAS_INSERTBEFORE
 pFind 項目の前に新しい項目を挿入します。
DPAS_INSERTAFTER
 pFind 項目の後に新しい項目を挿入します。

pitem

型: void*

挿入する項目へのポインター。

戻り値

なし

解説

メモ このマクロは、 DPA_InsertPtr 関数と DPA_Search関数を ラップします。
 
既定では、DPA が並べ替えられていることを示すために、DPAS_SORTED フラグが オプション に含まれています。

pFind 項目の配置方法の詳細については、「関数のDPA_Search」を参照してください。 新しい項目は、options パラメーターに従って pFind 項目の前または後に挿入されます。 pFind パラメーターは DPA に存在する必要はありません。 DPA に存在しない場合は、 pFind が並べ替えられた順序で DPA に挿入されていた新しい項目が挿入されます。

要件

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