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 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dpa_dsa.h