IIsoImageManager::Validate 方法 (imapi2fs.h)

判斷提供的 .iso 映像是否有效。

Syntax

HRESULT Validate();

傳回值

這個方法可以傳回其中一個值。

傳回碼 Description
IMAPI_E_IMAGEMANAGER_IMAGE_NOT_ALIGNED 影像未對齊 2 kb 磁區界限。
IMAPI_E_IMAGEMANAGER_NO_VALID_VD_FOUND 映射不包含有效的磁片區描述元。
IMAPI_E_IMAGEMANAGER_NO_IMAGE 在呼叫此方法之前,尚未使用 SetPathSetStream 方法來設定 映射。
IMAPI_E_IMAGEMANAGER_IMAGE_TOO_BIG 提供的映射太大,無法驗證大小超過 MAXLONG。

備註

若要讓這個方法成功,磁片映射可能是檔案或資料流程,必須符合下列準則:

  • 磁片映射大小必須是磁區使用者資料大小的倍數,2048 個位元組。
  • 磁片映射必須只包含使用者資料,而且沒有磁區標頭或檔頭。
  • 磁片磁碟機映射必須包含至少一個磁片區辨識序列,如 ECMA 119167、168標準中所述。

如果磁片映射不符合這些準則,這個方法會傳回相關的失敗碼。 更重要的是,驗證失敗會影響在錄製之後 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、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 imapi2fs.h

另請參閱