Share via


EwfMgrGetProtectedVolumeList (Standard 8)

7/8/2014

Review the use, syntax, parameters, and return values of the EwfMgrGetProtectedVolumeList function of the EWF API in Windows Embedded 8 Standard (Standard 8).

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

Returns 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.

Returns NULL if the function is not successful. 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 in EWF API Code Sample (Sample.cpp) show you how to use the EwfMgrGetProtectedVolumeList function.

Requirements

Header

ewfapi.h

Library

ewfapi.lib

See Also

Reference

EwfMgrVolumeNameListIsEmpty
EwfMgrVolumeNameEntryPop
EwfMgrVolumeNameListDelete
EWF_VOLUME_NAME_ENTRY

Concepts

EWF API Functions