EwfMgrOpenOverlayStore

This function opens an Enhanced Write Filter (EWF) overlay store volume.

  HANDLE EwfMgrOpenOverlayStore(
    BOOL 
  fOpenForAsyncIO
  );

Parameters

• fOpenForAsyncIO
  [in] If TRUE, an overlapped structure must be passed to EwfMgrRegisterLowSpaceNotification for asynchronous operation; otherwise, the behavior is undefined.

  If FALSE, a value of NULL must be passed to EwfMgrRegisterLowSpaceNotification for synchronous operation; otherwise, the behavior is undefined.

Return Values

If the function succeeds, the return value is a HANDLE to the EWF Overlay store volume.

If the function fails, the return value is INVALID_HANDLE_VALUE. Call GetLastError for extended error information.

Remarks

Use the EwfMgrClose function to close an object handle that was returned by EwfMgrOpenOverlayStore.

Requirements

OS Versions: Windows XP Embedded.
Header: Ewfapi.h.
Link Library: Ewfapi.dll, Ewfapi.lib.

Code Example

The following routine(s), which are included in the EWF API Code Sample (Sample.cpp), demonstrate how to use this function:

DumpEwfOverlayConfig

DoEwfRegisterLowSpaceSync

DoEwfRegisterLowSpaceAsync

See Also

EWF API Functions | EwfMgrClose | EWF API Code Sample

Last updated on Wednesday, October 18, 2006

© 2006 Microsoft Corporation. All rights reserved.