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，否則傳回錯誤值，包括下列專案：

傳回碼	Description
E_FAIL	無法載入檔案，或呼叫端應用程式透過對已註冊 IShellImageDataAbort 的呼叫停止譯碼程式， (請參閱 IShellImageData：：RegisterAbort 以取得詳細資訊) 。
E_OUTOFMEMORY	無法具現化內部物件。
E_NOTIMPL	用來建立此 IShellImageData 實例的路徑是 URL。
S_FALSE	映像已經譯碼。

必須先呼叫 IShellImageData：:D ecode，才能呼叫大部分的 IShellImageData 方法。不這麼做會導致這些方法失敗。

IShellImageData：:D ecode 會嘗試維護原始影像的外觀比例，因此在 cxDesired 或 cyDesired 中傳遞的其中一個值可能會覆寫為這樣做。