DismMountImage 函数
将 WIM 或 VHD 映像文件装载到指定位置。
语法
HRESULT WINAPI DismMountImage(
_In_ PCWSTR ImageFilePath,
_In_ PCWSTR MountPath,
_In_ UINT ImageIndex,
_In_opt_ PCWSTR ImageName,
_In_ DismImageIdentifier ImageIdentifier,
_In_ DWORD Flags,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
参数
ImageFilePath [in]
本地计算机上 WIM 或 VHD 文件的路径。 需要 .wim、.vhd 或 .vhdx 文件扩展名。
MountPath [in]
映像的正确装载位置的路径。 此装载路径必须已存在于该计算机上。 .wim、.vhd 或 .vhdx 文件中的 Windows 映像可以装载到采用 NTFS 格式的驱动器上的空文件夹中。 .vhd 或 .vhdx 文件中的 Windows 映像也可以装载到未分配的驱动器号。 不可将映像装载到现有驱动器的根目录。
ImageIndex [in]
要装载的 WIM 文件中映像的索引。 对于 VHD 文件,必须指定 1
的索引。
ImageName [in,可选]
可选。 要装载的映像的名称。
ImageIdentifier [in]
DismImageIdentifier 枚举值,例如 DismImageIndex。
Flags [in]
要用于此操作的装载标志。 有关装载标志的详细信息,请参阅 DISM API 常量。
CancelEvent [in,可选]
可选。 可以设置此函数的 CancelEvent,以便在客户端发出信号时取消正在进行的操作。 如果在无法取消操作的阶段收到 CancelEvent,则该操作将继续并返回成功代码。 如果在收到 CancelEvent 后取消操作,则映像状态为未知。 应在继续操作之前验证映像状态,或者放弃更改并重新开始。
Progress [in,可选]
可选。 指向客户端定义的 DismProgressCallback 函数的指针。
UserData [in,可选]
可选。 用户定义的自定义数据。
返回值
如果成功,则返回 S_OK。
如果任何路径格式不正确,或者,如果 MountPath 或 ImageFilePath 不存在或无效,则返回 E_INVALIDARG。
如果发生其他错误,则返回映射到 HRESULT 的 Win32 错误代码。
注解
在装载映像后,使用 DismOpenSession 来启动服务会话。 有关详细信息,请参阅使用 DISM API。
不支持从网络上存储的 WIM 或 VHD 文件装载映像。 必须指定本地计算机上的文件。
若要从 VHD 文件装载映像,必须指定 1
的 ImageIndex。
MountPath 必须是该计算机上已经存在的文件路径。 WIM 和 VHD 文件中的映像可以装载到 NTFS 格式的驱动器上的空文件夹。 还可以将映像从 VHD 文件装载到未分配的驱动器号。 不可将映像装载到现有驱动器的根目录。
在装载 WIM 文件中的映像时,该映像可以通过 ImageIndex 指定的映像索引号或 ImageName 指定的映像名称来标识。 ImageIdentifier 指定是使用 ImageIndex 还是 ImageName 参数来标识映像。
示例
HRESULT hr = S_OK;
hr = DismMountImage(L” C:\\test\\images\\myimage.wim”, L"C:\\test\\offline", 1, NULL, DismImageIndex, DISM_MOUNT_READWRITE, NULL, NULL, NULL);
要求
要求 | 说明 |
---|---|
支持 .wim 文件的主机平台 | DISM API 可在 Windows 评估和部署工具包 (Windows ADK) 支持的任何操作系统上使用。 有关详细信息,请参阅 Windows ADK 技术参考。 |
支持 .vhd 和 .vhdx 文件的主机平台 | Windows 7、Windows Server 2008 R2、Windows PE 3.0、Windows 8、Windows Server 2012、Windows 预安装环境 (Windows PE) 4.0、Windows 8.1、Windows Server 2012 R2、Windows 10、Windows Server 2016 |
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
标头 | DismAPI.h |
Library | DismAPI.lib |
DLL | DismAPI.dll |