다음을 통해 공유

IShellIconOverlay::GetOverlayIconIndex 메서드(shlobj_core.h)

  • 아티클

시스템 이미지 목록에서 아이콘 오버레이의 인덱스 를 가져옵니다.

구문

HRESULT GetOverlayIconIndex(
  [in]      PCUITEMID_CHILD pidl,
  [in, out] int             *pIconIndex
);

매개 변수

[in] pidl

형식: PCUITEMID_CHILD

아이콘이 표시되는 개체를 식별하는 ITEMIDLIST 구조체에 대한 포인터입니다.

[in, out] pIconIndex

형식: int*

시스템 이미지 목록에서 아이콘 오버레이 이미지의 인덱스 포인터입니다. 이 인덱스는 ImageList::SetOverlayImage 함수를 사용하여 개인 이미지 목록에 오버레이 이미지를 추가할 때 지정된 iImage 값과 동일합니다.

반환 값

형식: HRESULT

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 오버레이의 인덱스가 발견되었습니다.
S_FALSE
 이 파일에 대한 오버레이가 없습니다.
E_FAIL
 PIDL이 잘못되었습니다.

설명

시스템 이미지 목록에서 오버레이의 이미지 인덱스를 검색하려면 먼저 SHGetIconOverlayIndex 를 호출하여 오버레이 인덱스를 검색해야 합니다. 그런 다음 INDEXTOOVERLAYMASK 매크로를 사용하여 오버레이 인덱스를 해당하는 이미지 인덱스로 변환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 shlobj_core.h
DLL Shell32.dll(버전 5.0 이상)

추가 정보

IShellIconOverlay