Share via


EwfMgrGetProtectedVolumeList (Standard 7 SP1)

7/8/2014

This function gets a list of all the Enhanced Write Filter (EWF)-protected volume names.

Syntax

PEWF_VOLUME_NAME_ENTRY EwfMgrGetProtectedVolumeList(VOID);

Parameters

None.

Return Value

If the function succeeds, the return value is a pointer to an EWF_VOLUME_NAME_ENTRY list. The list contains the names of the volumes that were added to the ProtectedVolumes setting when configuring EWF and is irrespective of whether EWF is currently protecting those volumes. If no volumes were added to the ProtectedVolumes setting when configuring EWF, the list contains the names of all volumes that exist on the device.

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

Remarks

The caller should use the EwfMgrVolumeNameListDelete function to free the list when it is no longer needed.

Example

The DumpEwfProtectedVolumes and DoEwfCommands functions included in EWF API Code Sample (Sample.cpp) show you how to use the EwfMgrGetProtectedVolumeList function.

Requirements

OS Versions: Standard 7

Header: Ewfapi.h

Link Library: Ewfapi.lib

See Also

Reference

EwfMgrVolumeNameListIsEmpty
EwfMgrVolumeNameEntryPop
EwfMgrVolumeNameListDelete
EWF_VOLUME_NAME_ENTRY

Concepts

EWF API Functions