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 Server 2003 Service Pack 1 (SP1)、Windows XP と Service Pack 2 (SP2)、Windows Vista で Windows Feature Pack for Storage でサポートされています。 この更新プログラム パッケージによって提供されるすべての機能は、Windows 7 および Windows Server 2008 R2 でネイティブにサポートされています。

要件

サポートされている最小のクライアント	Windows Vista、SP2 を使用した Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	imapi2fs.h

こちらもご覧ください

• IIsoImageManager