Share via


EwfMgrOpenOverlayStore (Standard 8)

7/8/2014

Review the use, syntax, parameters, and return values of the EwfMgrOpenOverlayStore function of the EWF API in Windows Embedded 8 Standard (Standard 8).

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

Syntax

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 Value

If the function succeeds, returns a HANDLE to the EWF overlay store volume.

If the function fails, returns INVALID_HANDLE_VALUE. Call GetLastError for extended error information.

Remarks

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

Example

The DumpEwfOverlayConfig, DoEwfRegisterLowSpaceSync, and DoEwfRegisterLowSpaceAsync functions in EWF API Code Sample (Sample.cpp) show you how to use the EwfMgrOpenOverlayStore function.

Requirements

Header

ewfapi.h

Library

ewfapi.lib

See Also

Reference

EwfMgrClose

Concepts

EWF API Functions