Share via

iIsoImageManager：：Validate 方法 (imapi2fs.h)

  • 项目

确定提供的 .iso 映像是否有效。

语法

HRESULT Validate();

返回值

此方法可以返回其中一个值。

返回代码 说明
IMAPI_E_IMAGEMANAGER_IMAGE_NOT_ALIGNED 图像在 2kb 扇区边界上不对齐。
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 标准中所述。

如果光盘映像不符合这些条件，此方法将返回相关的失败代码。 更重要的是，当 Windows 在录制后装载映像时，验证失败将影响操作成功的概率。

Windows Server 2003 支持此方法，Service Pack 1 (SP1) 、Windows XP with Service Pack 2 (SP2) ，以及 Windows Vista 通过用于存储的 Windows 功能包。 Windows 7 和 Windows Server 2008 R2 原生支持此更新包提供的所有功能。

要求

   
最低受支持的客户端 Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2fs.h

另请参阅