IShellImageDataFactory::GetDataFormatFromPath メソッド (shimgdata.h)

拡張子に基づいてファイルの形式を決定します。

構文

HRESULT GetDataFormatFromPath(
  [in]  LPCWSTR pszPath,
  [out] GUID    *pDataFormat
);

[in] pszPath

種類: LPCWSTR

ファイルへのパス。

[out] pDataFormat

型: GUID*

ファイルのイメージ形式を識別する GUID へのポインター。

型: HRESULT

成功した場合はS_OKを返し、それ以外の場合は次のようなエラー値を返します。

リターンコード	説明
E_FAIL	pszPath パラメーターが NULL であるか、ファイル名拡張子が定義済みの GDI+ デコーダーに対応していないか、内部エラーが発生しました。いずれの場合も、 pDataFormat は GUID_NULL に設定されます。
E_OUTOFMEMORY	内部オブジェクトをインスタンス化できません。

IShellImageDataFactory::GetDataFormatFromPath は、データを現在のシステム上の特定の形式に保存できるかどうかを判断するためにのみ使用する必要があります。