DismOpenSession function

Associates an offline or online Windows image with a DISMSession.

Syntax

HRESULT WINAPI DismOpenSession(
  _In_     PCWSTR      ImagePath,
  _In_opt_ PCWSTR      WindowsDirectory,
  _In_opt_ PCWSTR      SystemDrive,
  _Out_    DismSession *Session
);

Parameters

ImagePath [in]
Set ImagePath to one of the following values:

• An absolute or relative path to the root directory of an offline Windows image.
• An absolute or relative path to the root directory of a mounted Windows image. You can mount the image before calling DismOpenSession by using an external tool or by using DismMountImage.
• DISM_ONLINE_IMAGE to associate the Session with the online Windows installation.

WindowsDirectory [in, optional]
Optional. A relative or absolute path to the Windows directory. The path is relative to the mount point.

If the value of WindowsDirectory is NULL, the default value of "Windows" is used.

The WindowsDirectory parameter cannot be used when the ImagePath parameter is set to DISM_ONLINE_IMAGE.

SystemDrive [in, optional]
Optional. The letter of the system drive that contains the boot manager. If SystemDrive is NULL, the default value of the drive containing the mount point is used.

The SystemDrive parameter cannot be used when the ImagePath parameter is set to DISM_ONLINE_IMAGE.

Session [out]
A valid DismSession. The DismSession must be associated with an image. You can associate a session with an image by using the DismOpenSession.

Return value

Returns S_OK on success.

Returns HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) if the DismSession already has an image associated with it.

Returns a Win32 error code mapped to an HRESULT for other errors.

Remarks

The DismSession can be used to service the image after the DismOpenSession call is successfully completed. The DismSession must be shut down by calling DismCloseSession.

Example

HRESULT hr = S_OK;
DismSession Session = DISM_SESSION_DEFAULT;
hr = DismOpenSession(L"C:\\Mount\\", NULL, NULL, &Session);

Requirements

See also

DismSession

DismCloseSession

DismMountImage