Stores information about an image in the Windows image (.wim) file.

BOOL
WINAPI
WIMSetImageInformation(
	HANDLE hImage,
	PVOID  pvImageInfo,
	DWORD  cbImageInfo
	);

Parameters

hImage

[in] A handle returned by the WIMCreateFile, WIMLoadImage, or WIMCaptureImage functions.

pvImageInfo

[in] A pointer to a buffer that contains information about the volume image.

cbImageInfo

[in] Specifies the size, in bytes, of the buffer pointed to by the pvImageInfo parameter.

Return Value

If the function succeeds, then the return value is nonzero.

If the function fails, then the return value is zero. To obtain extended error information, call the GetLastError function.

Remarks

The data buffer being passed into the function must be the memory representation of a Unicode XML file. Calling this function replaces any customized image data, so, to preserve existing XML information, call the WIMGetImageInformation function and append or edit the data.

If the input handle is from the WIMCreateFile function, then the XML data must be enclosed by <WIM></WIM> tags. If the input handle is from the WIMLoadImage or WIMCaptureImage functions, then the XML data must be enclosed by <IMAGE></IMAGE> tags.

See Also