IThumbnailProvider 인터페이스(thumbcache.h)

썸네일 이미지를 가져오기 위한 메서드를 노출하며 썸네일 처리기를 위해 구현될 예정입니다. 이 인터페이스를 구현하는 개체는 IInitializeWithStream도 구현해야 합니다.

상속

IThumbnailProvider 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IThumbnailProvider 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IThumbnailProvider 인터페이스에는 이러한 메서드가 있습니다.

IThumbnailProvider::GetThumbnail 썸네일 이미지 및 알파 형식을 가져옵니다.

설명

Shell은 IThumbnailProvider::GetThumbnail 을 호출하여 항목의 표현으로 사용할 이미지를 가져옵니다.

사진 미리 보기에 대한 이 인터페이스의 구현은 microsoft Windows에서 CLSID_PhotoThumbnailProvider 제공됩니다. 제공된 구현을 사용하는 애플리케이션은 GUID {C7657C4A-9F68-40fa-A4DF-96BC08EB3551}을 사용하여 상수 CLSID 식별자를 정의해야 합니다.

// {C7657C4A-9F68-40fa-A4DF-96BC08EB3551}
const CLSID CLSID_PhotoThumbnailProvider = {0xC7657C4A, 0x9F68, 0x40fa, {0xA4, 0xDF, 0x96, 0xBC, 0x08, 0xEB, 0x35, 0x51}} ;

초기화 이 인터페이스를 구현하는 개체는 IInitializeWithStream도 구현해야 합니다. 셸은 항목 스트림 을 사용하여 IInitializeWithStream::Initialize 를 호출하고 IInitializeWithStream 은 IThumbnailProvider 인스턴스가 프로시저 외부로 로드될 때 사용되는 유일한 초기화 인터페이스입니다(격리 목적으로). 모든 IThumbnailCache 코드 경로에 대한 Windows의 기본 코드 경로입니다.

IThumbnailCache API를 사용하지 않고 타사에서 처리기를 요청할 때 썸네일 구현을 IInitializeWithItem 또는 IInitializeWithFile 로 초기화할 수 있지만 이는 일반적이지 않습니다. IInitializeWithItem을 구현하는 경우 셸은 항목의 IShellItem 표현을 사용하여 IInitializeWithItem::Initialize를 호출합니다. IInitializeWithFile을 구현하는 경우 셸은 파일 경로를 사용하여 IInitializeWithFile::Initialize를 호출합니다.

이러한 인터페이스가 없으면 IThumbnailProvider 가 호출되지 않습니다.

클라이언트 앱 클라이언트 앱을 개발하는 경우 대신 IShellItemImageFactory 를 사용해야 합니다.

Windows Vista IThumbnailProivder는 Vista의 새로운 기능이며 IExtractImage를 대체합니다. Vista는 여전히 IExtractImage를 지원하지만 이미지 형식(알파 여부)을 반환할 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	thumbcache.h