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

아티클
08/26/2023

ID가 지정된 경우 썸네일 캐시에서 썸네일을 가져옵니다.

구문

HRESULT GetThumbnailByID(
  [in]            WTS_THUMBNAILID thumbnailID,
  [in]            UINT            cxyRequestedThumbSize,
  [out, optional] ISharedBitmap   **ppvThumb,
  [out, optional] WTS_CACHEFLAGS  *pOutFlags
);

매개 변수

[in] thumbnailID

형식: WTS_THUMBNAILID

검색할 썸네일의 ID입니다. ID는 GetThumbnail을 호출하여 가져옵니다.

[in] cxyRequestedThumbSize

형식: UINT

요청된 썸네일 크기(픽셀)입니다. 이 값은 1024보다 클 수 없습니다.

[out, optional] ppvThumb

형식: ISharedBitmap**

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

[out, optional] pOutFlags

형식: WTS_CACHEFLAGS*

이 메서드가 성공적으로 반환될 때 다음 플래그의 조합을 수신하는 값에 대한 포인터입니다. 이 정보가 필요하지 않은 경우 이 값을 NULL 로 설정할 수 있습니다.

WTS_DEFAULT(0x00000000)

0x00000000.

WTS_LOWQUALITY(0x00000001)

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

WTS_CACHED(0x00000002)

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

반환 값

형식: HRESULT

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

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

설명

이 메서드는 일반적으로 GetThumbnail 이 미리 보기 ID를 검색하기 위해 이미 호출된 후에 호출됩니다.

요구 사항


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

다음을 통해 공유