IThumbnailCache::GetThumbnail 메서드(thumbcache.h)
지정된 셸 항목에 대해 캐시된 썸네일을 가져옵니다.
구문
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 오류 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
매개 변수가 잘못되었습니다. |
|
Shell 항목은 미리 보기 추출을 지원하지 않습니다. 예를 들어 항목을 .exe 또는 .lnk. |
|
추출이 허용되는 최대 시간보다 오래 걸렸습니다. 추출이 완료되지 않았습니다. |
|
서로게이트 프로세스를 추출 프로세스에 사용할 수 없습니다. |
|
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 |