This function sets the overlay level on an Enhanced Write Filter (EWF)-protected volume for disk overlays.

BOOL EwfMgrSetLevel(
  HANDLE hDevice,
  OPTIONAL LPCWSTR lpDescription,
  int Level,
  BOOL fDeleteLevel


[in] Handle to the EWF-protected volume.
[in] Long pointer to an optional description to associate with the new overlay level. This optional description can contain up to EWF_MAX_LEVEL_NAME_LENGTH characters. If the length is equal to EWF_MAX_LEVEL_NAME_LENGTH, no null terminator is stored. This parameter is optional, and can be set to NULL. This parameter is ignored unless Level is equal to current level + 1.
[in] Describes the level to set as the new overlay level. The following table shows the possible values.
current_level +1Starts a new overlay at Level. The value of Level must be less than or equal to MaxLevels, as specified by EwfMgrGetProtectedVolumeConfig.
0Discards all overlay data and sets the level to 1.
1 through current_levelSets the level to Level, discarding all data above the specified level.

If Level is current_level +1, EWF adds an overlay. If Level is less than the current_level, EWF deletes overlay levels.

[in] If TRUE, all data in and above the specified level is deleted.

Return Values

If the function succeeds, the return value is TRUE.

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


The level is set on the next restart.

This function is only supported on disk overlays.


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:


See Also

EWF API Functions | EwfMgrCheckpoint | EwfMgrRestore | EWF API Code Sample

© 2006 Microsoft Corporation. All rights reserved.