EwfMgrCheckpoint

Article
10/07/2008

This function adds a checkpoint overlay level on the specified Enhanced Write Filter (EWF)-protected volume.

  BOOL EwfMgrCheckpoint(
    HANDLE 
  hDevice
  ,
    OPTIONAL LPCWSTR
  lpDescription
  );

Parameters

hDevice
[in] Handle to the EWF-protected volume.
lpDescription
[in] Long pointer to an optional description to associate with the new overlay level. Can be 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.

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.

Remarks

The checkpoint is set on the next restart.

This function is supported on disk overlays only. The current level must be less than MaxLevels as returned by EwfMgrGetProtectedVolumeConfig.

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:

DoEwfCheckPoint