IThumbnailCache::GetThumbnail 메서드(thumbcache.h)

아티클
08/26/2023

지정된 셸 항목에 대해 캐시된 썸네일을 가져옵니다.

구문

HRESULT GetThumbnail(
  [in]            IShellItem      *pShellItem,
  [in]            UINT            cxyRequestedThumbSize,
  [in]            WTS_FLAGS       flags,
  [out, optional] ISharedBitmap   **ppvThumb,
  [out, optional] WTS_CACHEFLAGS  *pOutFlags,
  [out, optional] WTS_THUMBNAILID *pThumbnailID
);

매개 변수

[in] pShellItem

형식: IShellItem*

썸네일을 검색할 셸 항목에 대한 포인터입니다.

[in] cxyRequestedThumbSize

형식: UINT

요청된 썸네일 크기(픽셀)입니다. 최댓값은 1,024입니다.

[in] flags

형식: WTS_FLAGS

WTS_FLAGS 열거형의 값 조합입니다. 규칙 및 가능한 조합 목록은 설명 섹션을 참조하세요.

[out, optional] ppvThumb

형식: ISharedBitmap**

이 메서드가 성공적으로 반환될 때 미리 보기에 액세스하는 데 사용되는 개체를 수신하는 ISharedBitmap 포인터의 주소입니다. 이 매개 변수는 NULL일 수 있습니다.

[out, optional] pOutFlags

형식: WTS_CACHEFLAGS*

이 메서드가 성공적으로 반환될 때 WTS_CACHEFLAGS 열거형에서 다음 플래그의 조합을 수신하는 값에 대한 포인터입니다.

WTS_DEFAULT(0x00000000)

0x00000000.

WTS_LOWQUALITY(0x00000001)

0x00000001. 반환된 비트맵 차원이 cxyRequestedThumbSize보다 작은 경우 설정합니다.

WTS_CACHED(0x00000002)

0x00000002. 반환된 이미지가 캐시에 있을 때 설정합니다.

[out, optional] pThumbnailID

형식: WTS_THUMBNAILID*

이 메서드가 성공적으로 반환될 때 반환된 썸네일의 고유 ID를 수신하는 값에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있으며, 이 경우 썸네일 ID가 삭제됩니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 다음을 포함하여 표준 COM 오류 값을 반환합니다.

반환 코드	설명
E_INVALIDARG	매개 변수가 잘못되었습니다.
WTS_E_FAILEDEXTRACTION	Shell 항목은 미리 보기 추출을 지원하지 않습니다. 예를 들어 항목을 .exe 또는 .lnk.
WTS_E_EXTRACTIONTIMEDOUT	추출이 허용되는 최대 시간보다 오래 걸렸습니다. 추출이 완료되지 않았습니다.
WTS_E_SURROGATEUNAVAILABLE	서로게이트 프로세스를 추출 프로세스에 사용할 수 없습니다.
WTS_E_FASTEXTRACTIONNOTSUPPORTED	WTS_FASTEXTRACT 플래그가 설정되었지만 빠른 추출을 사용할 수 없습니다.

설명

썸네일이 추출되면 WTS_EXTRACTDONOTCACHE 지정하지 않으면 캐시됩니다.

다음 조합은 flags 매개 변수에 유효합니다.

WTS_INCACHEONLY

WTS_FASTEXTRACT

WTS_EXTRACT

WTS_EXTRACT | WTS_SLOWRECLAIM

WTS_FORCEEXTRACTION

WTS_FORCEEXTRACTION | WTS_SLOWRECLAIM

WTS_EXTRACTDONOTCACHE

GetImage 는 또한 이 캐시를 사용하며 썸네일을 검색하는 더 쉬운 방법을 제공할 수 있습니다. 그러나 GetImage 는 더 일반적이며 아이콘을 대체로 검색합니다.

요구 사항

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

추가 정보

IShellItemImageFactory::GetImage

IThumbnailCache

다음을 통해 공유