SHGetImageList 함수(shellapi.h)

이미지 목록을 검색합니다.

구문

SHSTDAPI SHGetImageList(
  [in]  int    iImageList,
  [in]  REFIID riid,
  [out] void   **ppvObj
);

매개 변수

[in] iImageList

형식: int

목록에 포함된 이미지 형식입니다. 다음 값 중 하나입니다.

SHIL_LARGE(0x0)

0x0. 이미지 크기는 일반적으로 32x32 픽셀입니다. 그러나 표시 속성의 모양 탭에 있는 효과 섹션에서 큰 아이콘 사용 옵션을 선택하면 이미지는 48x48픽셀입니다.

SHIL_SMALL(0x1)

0x1. 이러한 이미지는 셸 표준 16x16의 작은 아이콘 크기이지만 사용자가 크기를 사용자 지정할 수 있습니다.

SHIL_EXTRALARGE(0x2)

0x2. 이러한 이미지는 Shell 표준 초대형 아이콘 크기입니다. 일반적으로 48x48이지만 사용자가 크기를 사용자 지정할 수 있습니다.

SHIL_SYSSMALL(0x3)

0x3. 이러한 이미지는 SM_CYSMICON 호출된 SM_CXSMICON 및 GetSystemMetrics를 사용하여 호출된 GetSystemMetrics에 의해 지정된 크기입니다.

SHIL_JUMBO(0x4)

0x4. Windows Vista 이상. 이미지는 일반적으로 256x256픽셀입니다.

SHIL_LAST

유효성 검사를 위해 유효한 가장 큰 플래그 값입니다.

[in] riid

형식: REFIID

일반적으로 IID_IImageList 이미지 목록 인터페이스 식별자에 대한 참조입니다.

[out] ppvObj

형식: void**

이 메서드가 반환되면 는 riid에서 요청된 인터페이스 포인터를 포함합니다. 일반적으로 IImageList입니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

ppv 매개 변수에 반환된 것과 같은 IImageList 포인터 형식은 필요에 따라 HIMAGELIST로 캐스팅할 수 있습니다. 예를 들어 목록 보기에서 사용할 수 있습니다. 반대로 HIMAGELIST 를 IImageList에 대한 포인터로 캐스팅할 수 있습니다.

Windows Vista를 기준으로 프로세스가 dpi 인식으로 표시된 경우 SHIL_SMALL, SHIL_LARGE 및 SHIL_EXTRALARGE 크기가 dpi(인치당 점)로 표시됩니다. 이러한 형식을 dpi 인식으로 설정하려면 SetProcessDPIAware를 호출합니다. SHIL_JUMBO dpi 인식 설정에 관계없이 256픽셀로 고정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shellapi.h
DLL	Shell32.dll
API 세트	ext-ms-win-shell-shell32-l1-2-2(Windows 10 버전 10.0.14393에 도입됨)

추가 정보

FileIconInit