ImageList_CoCreateInstance 함수(commoncontrols.h)

이미지 목록의 단일 인스턴스를 만들고 해당 인스턴스에 대한 인터페이스 포인터를 반환합니다.

구문

HRESULT ImageList_CoCreateInstance(
  [in]           REFCLSID       rclsid,
  [in, optional] const IUnknown *punkOuter,
  [in]           REFIID         riid,
  [out]          void           **ppv
);

매개 변수

[in] rclsid

형식: REFCLSID

만들 COM 개체를 식별하는 GUID인 CLSID에 대한 참조입니다. CLSID_ImageList 합니다.

[in, optional] punkOuter

형식: const IUnknown*

이 함수에서 만든 개체를 집계하는 외부 IUnknown 인터페이스에 대한 포인터이거나, 집계가 필요한 경우 NULL 입니다.

[in] riid

형식: REFIID

원하는 인터페이스 ID에 대한 참조입니다.

[out] ppv

형식: void**

이 메서드가 반환되면 riid에서 요청된 인터페이스 포인터가 포함됩니다. 일반적으로 Initialize 메서드를 제공하는 IImageList2입니다.

반환 값

형식: HRESULT

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

설명

이 함수를 호출하기 전에 CoInitialize 또는 CoInitializeEx 를 호출하여 COM 을 초기화해야 합니다.

사용자 지정된 이미지 목록에 대한 ImageList_CoCreateInstance 호출합니다. 그렇지 않으면 SHGetImageList 를 호출하여 시스템 이미지 목록을 로드합니다. uflag 매개 변수를 SHGFI_SYSICONINDEX 설정하여 SHGetFileInfo를 호출하여 시스템 이미지 목록에 대한 핸들을 검색합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	commoncontrols.h
라이브러리	Comctl32.lib
DLL	Comctl32.dll