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 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈