Share via


EwfMgrGetDriveLetterFromVolumeName (Standard 7 SP1)

7/8/2014

This function gets the drive letter for the specified device name for an Enhanced Write Filter (EWF)-protected volume.

Syntax

WCHAR EwfMgrGetDriveLetterFromVolumeName(
  LPCWSTR lpVolumeName
);

Parameters

  • lpVolumeName
    [in] Long pointer to the specified volume name.

Return Value

If the method succeeds, it returns the drive letter as a WCHAR value. If the function fails, it returns -1.

Remarks

The volume name must be expressed in one of the following valid means:

  • An extended path, such as \\?\GLOBALROOT\Device\HarddiskVolume1.

  • A fully-qualified volume name, such as those returned by EwfMgrGetProtectedVolumeList. For example,

    \\?\storage#volume#1&37a96558&0&signature20c19bc2offset27119f401ngth18e955c00#{68bef3a0-82af-4f8a-b3d3-bd5dde13b413}
    

Example

The DisplayEWFVolumeConfig and DumpEwfProtectedVolumes functions, which are included in EWF API Code Sample (Sample.cpp), show you how to use the EwfMgrGetDriveLetterFromVolumeName function.

Requirements

OS Versions: Standard 7

Header: Ewfapi.h

Link Library: Ewfapi.lib

See Also

Concepts

EWF API Functions