SHMapPIDLToSystemImageListIndex 함수(shlobj_core.h)

[SHMapPIDLToSystemImageListIndex 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

폴더 항목과 연결된 시스템 이미지 목록에서 아이콘 인덱스를 검색합니다.

구문

int SHMapPIDLToSystemImageListIndex(
  [in]            IShellFolder    *pshf,
  [in]            PCUITEMID_CHILD pidl,
  [out, optional] int             *piIndexSel
);

매개 변수

[in] pshf

형식: IShellFolder*

항목이 포함된 폴더에 대한 IShellFolder 인터페이스 포인터입니다.

[in] pidl

형식: PCUITEMID_CHILD

항목의 ITEMIDLIST 구조체에 대한 포인터입니다.

[out, optional] piIndexSel

형식: int*

이 함수가 성공적으로 반환되면 시스템 이미지 목록에서 항목의 열린 아이콘 인덱스를 수신하는 int에 대한 포인터입니다. 항목에 특별한 열린 아이콘이 없으면 해당 일반 아이콘의 인덱스가 반환됩니다. 열려 있는 아이콘이 있고 가져올 수 없는 경우 piIndex에서 가리키는 값이 -1로 설정됩니다. 호출하는 애플리케이션이 열려 있는 아이콘에 관심이 없는 경우 이 매개 변수는 NULL일 수 있습니다.

반환 값

형식: int

성공하면 시스템 이미지 목록에서 항목의 일반 아이콘 인덱스 또는 -1을 반환합니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 5.0 이상)