EwfMgrGetPersistentData

This function gets the persistent data for an Enhanced Write Filter (EWF)-protected volume.

  BOOL EwfMgrGetPeristentData(
    HANDLE 
  hDevice,
  LPBYTElpPersistentData,
  DWORDcbPersistentData);

Parameters

  • hDevice
    [in] Handle to the EWF-protected volume.
  • lpPersistentData
    [out] Long pointer to a buffer to receive the persistent data.
  • cbPersistentData
    [in] Specifies the size, in bytes, of the buffer that is pointed to by lpPersistentData. Only the first EWF_MAX_PERSISTENT_DATA bytes are retrieved.

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

This function is supported on both disk and RAM overlays with an associated EWF overlay store tracking its protection settings. However, it is not supported on RAM overlays that are described only within the registry.

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:

DoEwfPersistCommands

See Also

EWF API Functions | EwfMgrSetPersistentData | EWF API Code Sample

Last updated on Wednesday, October 18, 2006

© 2006 Microsoft Corporation. All rights reserved.