Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

EwfMgrSetPersistentData

This function sets the persistent data for an Enhanced Write Filter (EWF)-protected volume. Persistent data (32 bytes per protected volume) is retained through all EWF operations, including disable, enable, and restore operations.

BOOL EwfMgrSetPeristentData(
  HANDLE hDevice,
  LPBYTE lpPersistentData,
  DWORD cbPersistentData
);

Parameters

hDevice
[in] Handle to the EWF-protected volume.
lpPersistentData
[in] Long pointer to a buffer that contains the persistent data to save.
cbPersistentData
[in] Specifies the size, in bytes, of the buffer pointed to by lpPersistentData. Only the first 32 bytes (EWF_MAX_PERSISTENT_DATA) are saved.

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.

This function can be used to store EWF-specific state information and can be useful when upgrading a device. Persistent data is stored in the EWF volume store.

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 | EwfMgrGetPersistentData | EWF API Code Sample


© 2006 Microsoft Corporation. All rights reserved.


Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.