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 装载映像时操作成功的概率。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 具有 SP2 的 Windows Vista、Windows XP [仅限桌面应用] |
支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | 窗户 |
标头 | imapi2fs.h |