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 이상) |