IIsoImageManager::Validate メソッド (imapi2fs.h)

指定された.isoイメージが有効かどうかを判断します。

構文

HRESULT Validate();

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	形容
IMAPI_E_IMAGEMANAGER_IMAGE_NOT_ALIGNED	イメージが 2 kb のセクター境界に配置されていません。
IMAPI_E_IMAGEMANAGER_NO_VALID_VD_FOUND	イメージに有効なボリューム記述子が含まれていません。
IMAPI_E_IMAGEMANAGER_NO_IMAGE	このメソッドを呼び出す前に、SetPath または SetStream メソッド使用してイメージが設定されていません。
IMAPI_E_IMAGEMANAGER_IMAGE_TOO_BIG	指定されたイメージが大きすぎて、サイズが MAXLONG を超えているので検証できません。

このメソッドを成功させるには、ディスクイメージ (ファイルまたはストリーム) が次の条件を満たしている必要があります。

ディスクイメージのサイズは、セクターユーザーデータサイズ (2048 バイト) の倍数である必要があります。
ディスクイメージにはユーザーデータのみを含め、セクターヘッダーまたはファイルヘッダーは含めてはなりません。
ディスクイメージには、ECMA 119、167、168 標準で説明されているボリューム記述子が少なくとも 1 つ含まれている有効なボリューム認識シーケンスが含まれている必要があります。

ディスクイメージがこれらの条件に適合しない場合、このメソッドは関連するエラーコードを返します。さらに重要なのは、検証に失敗すると、記録後に Windows によってイメージがマウントされたときに、操作が成功する確率に影響します。

要件	価値
サポートされる最小クライアント	Windows Vista、WINDOWS XP SP2 [デスクトップアプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	imapi2fs.h