IShellImageData::D ecode 메서드(shimgdata.h)

이미지 파일을 디코딩하고 상태를 설정합니다.

구문

HRESULT Decode(
  [in] DWORD dwFlags,
  [in] ULONG cxDesired,
  [in] ULONG cyDesired
);

[in] dwFlags

형식:DWORD

다음 플래그 중 하나입니다.

전체 이미지를 만듭니다.

미리 보기 이미지만 디코딩합니다.

전체 이미지 파일을 메모리에 로드합니다.

[in] cxDesired

형식: ULONG

디코딩된 이미지의 원하는 가로 크기입니다. 이 매개 변수는 SHIMGDEC_THUMBNAIL 플래그가 설정된 경우에만 사용됩니다. SHIMGDEC_DEFAULT 플래그를 대신 설정하면 이 값은 무시됩니다.

[in] cyDesired

형식: ULONG

디코딩된 이미지의 원하는 세로 크기입니다. 이 매개 변수는 SHIMGDEC_THUMBNAIL 플래그가 설정된 경우에만 사용됩니다. SHIMGDEC_DEFAULT 플래그를 대신 설정하면 이 값은 무시됩니다.

형식: HRESULT

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

반환 코드	설명
E_FAIL	파일을 로드할 수 없거나 호출 애플리케이션이 등록된 IShellImageDataAbort 호출을 통해 디코딩 프로세스를 중지했습니다(자세한 내용은 IShellImageData::RegisterAbort 참조).
E_OUTOFMEMORY	내부 개체를 인스턴스화할 수 없습니다.
E_NOTIMPL	IShellImageData의 이 instance 만드는 데 사용된 경로는 URL이었습니다.
S_FALSE	이미지가 이미 디코딩되었습니다.

대부분의 IShellImageData 메서드를 호출하기 전에 IShellImageData::D ecode를 호출해야 합니다. 이렇게 하지 않을 경우 이러한 메서드가 실패합니다.

IShellImageData::D ecode 는 원래 이미지의 가로 세로 비율을 유지하려고 시도하므로 cxDesired 또는 cyDesired 로 전달 된 값 중 하나가 재정의될 수 있습니다.