DPA_SortedInsertPtr マクロ (dpa_dsa.h)

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

構文

int DPA_SortedInsertPtr(
   HDPA          hdpa,
   void          *pFind,
   int           iStart,
   PFNDPACOMPARE pfnCompare,
   LPARAM        lParam,
   UINT          options,
   void          *pitem
);

パラメーター

hdpa

型: HDPA

DPA へのハンドル。

pFind

型: void*

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

iStart

型: int

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

pfnCompare

型: PFNDPACOMPARE

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

lParam

型: LPARAM

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

options

型: UINT

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

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

pitem

型: void*

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

戻り値

型: int

新しい項目のインデックスを返すか、挿入アクションが失敗した場合に -1 します。

備考

メモ このマクロは、DPA_InsertPtr 関数と DPA_Search 関数をラップします。

 

DPAS_SORTED フラグは、DPA が並べ替えられていることを示すために既定で オプションに含まれています。

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	dpa_dsa.h