Saves the changes from a mounted image back to the.wim file.

BOOL
WINAPI
WIMCommitImageHandle(
	HANDLE  hImage,
	DWORD   dwCommitFlags,
	PHANDLE phNewImageHandle
	);

Parameters

hImage

[in] A handle to an image opened by the WIMLoadImage function. The .wim file must have been opened with a WIM_GENERIC_MOUNT flag in call to WIMCreateFile.

dwCommitFlags

[in] Specifies the features to use during the capture.

Flag Description

WIM_COMMIT_FLAG_APPEND

Adds a new image entry to the .wim file. The default is to update the image specified during mount.

WIM_FLAG_VERIFY

Capture verifies single-instance files byte by byte.

WIM_FLAG_NO_RP_FIX

Disables automatic path repairs for junctions and symbolic links.

WIM_FLAG_NO_DIRACL

Disables capturing security information for directories.

WIM_FLAG_NO_FILEACL

Disables capturing security information for files.

phNewImageHandle

[out opt] Pointer to receive the new image handle if the WIM_COMMIT_FLAG_APPEND flag is specified. If this parameter is NULL, the new image will be closed automatically.

Return Value

Returns TRUE and sets the LastError to ERROR_SUCCESS on the successful completion of this function. Returns FALSE in case of a failure and sets the LastError to the appropriate Win32® error value.

Remarks

The WIMCommitImageHandle function updates the contents of the given image in a .wim file to reflect the contents of the specified mount directory. After the successful completion of this operation, users or applications can still access the contents of the image mapped under the mount directory. Use the WIMUnmountImageHandle function to unmount the image from the mount directory using an image handle.

See Also