Функция 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. Вы можете подключить образ перед вызовом DismOpenSession с помощью внешнего средства или DismMountImage.
- DISM_ONLINE_IMAGE связать сеанс с сетевой установкой Windows.
WindowsDirectory [in, необязательный]
Необязательный элемент. Относительный или абсолютный путь к каталогу Windows. Путь относится к точке подключения.
Если значение WindowsDirectory равно NULL, используется значение по умолчанию "Windows".
Параметр WindowsDirectory нельзя использовать, если для параметра ImagePath задано значение DISM_ONLINE_IMAGE.
SystemDrive [в, необязательно]
Необязательный элемент. Буква системного диска, содержащего диспетчер загрузки. Если SystemDrive имеет значение NULL, используется значение по умолчанию для диска, содержащего точку подключения.
Параметр SystemDrive нельзя использовать, если для параметра ImagePath задано значение DISM_ONLINE_IMAGE.
Сеанс [out]
Допустимое DismSession. DismSession должен быть связан с изображением. Сеанс можно связать с изображением с помощью DismOpenSession.
Возвращаемое значение
Возвращает S_OK при успешном выполнении.
Возвращает значение HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) , если с DismSession уже связано изображение.
Возвращает код ошибки Win32, сопоставленный с HRESULT для других ошибок.
Комментарии
DismSession можно использовать для обслуживания образа после успешного завершения вызова DismOpenSession. DismSession необходимо завершить, вызвав DismCloseSession.
Пример
HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);
Требования
| Требование | Описание |
|---|---|
| Поддерживаемые платформы узлов | API DISM можно использовать в любой операционной системе, поддерживаемой комплектом средств для развертывания и оценки Windows (Windows ADK). Дополнительные сведения см. в техническом справочнике по Windows ADK. |
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Заголовок | DismAPI.h |
| Библиотека | DismAPI.lib |
| DLL | DismAPI.dll |