internal static void ExecuteAgainstMountedImage(string imagePath, string mountPath, string tempPath, bool readOnly, Action <WimHandle, WimHandle> action)
{
using (WimHandle wimHandle = WimgApi.CreateFile(imagePath, WimFileAccess.Read | WimFileAccess.Write | WimFileAccess.Mount, WimCreationDisposition.OpenExisting, WimCreateFileOptions.None, WimCompressionType.None))
{
WimgApi.SetTemporaryPath(wimHandle, tempPath);
using (WimHandle imageHandle = WimgApi.LoadImage(wimHandle, 1))
{
WimMountImageOptions flags = WimMountImageOptions.Fast | WimMountImageOptions.DisableDirectoryAcl | WimMountImageOptions.DisableFileAcl | WimMountImageOptions.DisableRPFix;
if (readOnly)
{
flags |= WimMountImageOptions.ReadOnly;
}
WimgApi.MountImage(imageHandle, mountPath, flags);
try
{
action?.Invoke(wimHandle, imageHandle);
}
finally
{
WimgApi.UnmountImage(imageHandle);
}
}
}
}
/// <summary>
/// Mounts an image in a Windows® image (.wim) file to the specified directory.
/// </summary>
/// <param name="imageHandle">A <see cref="WimHandle"/> of a a volume image returned by the <see cref="LoadImage"/> or <see cref="CaptureImage"/> method. The WIM file must have been opened with <see cref="WimFileAccess.Mount"/> flag in call to <see cref="CreateFile"/>.</param>
/// <param name="mountPath">The full file path of the directory to which the .wim file has to be mounted.</param>
/// <param name="options">Specifies how the file is to be treated and what features are to be used.</param>
/// <exception cref="ArgumentNullException">imageHandle or mountPath is null.</exception>
/// <exception cref="DirectoryNotFoundException">mountPath does not exist.</exception>
/// <exception cref="Win32Exception">The Windows® Imaging API reported a failure.</exception>
/// <remarks>This method maps the contents of the given image in a .wim file to the specified mount directory. After the successful completion of this operation, users or applications can access the contents of the image mapped under the mount directory. The WIM file containing the image must be opened with <see cref="WimFileAccess.Mount"/> access. Use the <see cref="UnmountImage(WimHandle)"/> method to unmount the image from the mount directory.</remarks>
public static void MountImage(WimHandle imageHandle, string mountPath, WimMountImageOptions options)
{
// See if imageHandle is null
if (imageHandle == null)
{
throw new ArgumentNullException(nameof(imageHandle));
}
// See if mountPath is null
if (mountPath == null)
{
throw new ArgumentNullException(nameof(mountPath));
}
// See if mount path does not exist
if (!Directory.Exists(mountPath))
{
throw new DirectoryNotFoundException($"Could not find a part of the path '{mountPath}'");
}
// Call the native function
if (!WimgApi.NativeMethods.WIMMountImageHandle(imageHandle, mountPath, (DWORD)options))
{
// Throw a Win32Exception based on the last error code
throw new Win32Exception();
}
}
