WIMCloseHandle

Closes an open Windows imaging (.wim) file or image handle.

BOOL
WINAPI
WIMCloseHandle(
    HANDLE hObject
    );

Parameters

hObject

[in] The handle to an open, image-based object.

Return Value

If the function succeeds, the return value is nonzero.

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

Remarks

The WIMCloseHandle function closes handles to the following objects:

  • A .wim file
  
  • A volume image
  

If there are any open volume image handles, closing a .wim file fails.

Use the WIMCloseHandle function to close handles returned by calls to the WIMCreateFile, WIMLoadImage, and WIMCaptureImage functions.

See Also

Concepts

WIMCreateFile
WIMLoadImage
WIMCaptureImage
WIMRegisterMessageCallback