DismOpenSession 函数
将脱机或联机 Windows 映像与 DISMSession 关联。
语法
HRESULT WINAPI DismOpenSession(
_In_ PCWSTR ImagePath,
_In_opt_ PCWSTR WindowsDirectory,
_In_opt_ PCWSTR SystemDrive,
_Out_ DismSession *Session
);
参数
ImagePath [in]
将 ImagePath 设置为以下值之一：
- 脱机 Windows 映像的根目录的绝对路径或相对路径。
- 已装载 Windows 映像的根目录的绝对路径或相对路径。 可以使用外部工具或 DismMountImage 在调用 DismOpenSession 之前装载映像。
- DISM_ONLINE_IMAGE，用于将会话与联机 Windows 安装进行关联。
WindowsDirectory [in, 可选]
可选。 Windows 目录的相对路径或绝对路径。 路径相对于装入点。
如果 WindowsDirectory 的值为NULL，则使用“Windows”的默认值。
当 ImagePath 参数设置为 DISM_ONLINE_IMAGE，WindowsDirectory 参数无法使用。
SystemDrive [in, 可选]
可选。 包含启动管理器的系统驱动器的号。 如果 SystemDrive 为 NULL，则使用包含装入点的驱动器的默认值
当 ImagePath 参数设置为DISM_ONLINE_IMAGE，SystemDrive 参数无法使用。
Session [out]
一个有效的 DismSession。 DismSession 必须关联一个映像。 可以使用 DismOpenSession 将会话与映像关联。
返回值
如果成功，则返回 S_OK。
如果 DismSession 已有与之关联的图像，则返回 HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)。
如果发生其他错误，则返回映射到 HRESULT 的 Win32 错误代码。
注解
DismSession 可用于在 DismOpenSession 调用成功完成后为映像提供服务。 必须通过调用 DismCloseSession 关闭 DismSession。
示例
HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);
要求
| 要求 | 说明 |
|---|---|
| 支持的主机平台 | DISM API 可在 Windows 评估和部署工具包 (Windows ADK) 支持的任何操作系统上使用。 有关详细信息，请参阅 Windows ADK 技术参考 |
| 最低受支持的客户端 | Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
| 标头 | DismAPI.h |
| Library | DismAPI.lib |
| DLL | DismAPI.dll |