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 のこのインスタンスの作成に使用されるパスは URL でした。
S_FALSE	イメージは既にデコードされています。

IShellImageData::D ecode は、ほとんどの IShellImageData メソッドを呼び出す前に呼び出す必要があります。これを行わないと、これらのメソッドが失敗します。

IShellImageData::D ecode は元のイメージの縦横比を維持しようとします。そのため、 cxDesired または cyDesired で渡された値の 1 つがオーバーライドされる可能性があります。