IShellIcon::GetIconOf 메서드(shobjidl_core.h)

특정 폴더 내의 개체에 대한 아이콘을 가져옵니다.

구문

HRESULT GetIconOf(
  PCUITEMID_CHILD pidl,
  UINT            flags,
  int             *pIconIndex
);

매개 변수

pidl

형식: LPCITEMIDLIST

폴더의 상대 위치를 지정하는 ITEMIDLIST 구조체의 주소입니다.

flags

형식: UINT

아이콘을 표시하는 방법을 지정하는 플래그입니다. 이 매개 변수는 0이거나 다음 값 중 하나일 수 있습니다.

GIL_FORSHELL

아이콘은 Shell 폴더에 표시됩니다.

GIL_OPENICON

열려 있는 상태 및 닫힌 상태 이미지를 모두 사용할 수 있는 경우 아이콘이 열려 있어야 합니다. 이 플래그를 지정하지 않으면 아이콘이 닫힌 상태여야 합니다. 이 플래그는 일반적으로 폴더 개체에 사용됩니다.

pIconIndex

형식: LPINT

시스템 이미지 목록의 아이콘 인덱스 주소입니다. 다음 표준 이미지 목록 인덱스를 반환할 수 있습니다.

0

문서(빈 페이지, 연결되지 않음)

1

문서(페이지의 데이터 포함)

2

애플리케이션(파일 이름 확장명은 .exe, .com 또는 .bat)

3

폴더(일반)

4

폴더(열기)

반환 값

형식: HRESULT

lpIconIndex에 올바른 시스템 이미지 목록 인덱스가 포함되어 있으면 S_OK 반환하거나, 이 개체에 대해 아이콘을 가져올 수 없는 경우 S_FALSE 반환합니다.

설명

GetIconOf를 사용하여 이 개체의 아이콘을 검색할 수 없는 경우 GetUIObjectOf 메서드를 사용하여 Extract 메서드를 지원하는 개체를 검색합니다.

CoInitialize가 먼저 호출되지 않으면 IShellIcon::GetIconOf가 실패합니다.

호출 애플리케이션에 대한 참고 사항

반환된 인덱스는 시스템 이미지 목록에서 가져옵니다.

구현자에 대한 참고 사항

사용된 아이콘 인덱스가 나열된 표준 이미지 중 하나가 아닌 경우 시스템 이미지 목록에 이미지를 추가한 다음 인덱스를 lpIconIndex 매개 변수에 배치하는 것은 구현자의 책임입니다. 시스템 이미지 목록이 너무 커지는 것을 방지하려면 각 이미지를 한 번만 추가해야 합니다.

요구 사항

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

추가 정보

IShellIcon