GetFullyQualifiedLocalPath method

This method is deprecated.

Converts a Volume GUID and Relative Path pair into a sting containing a fully qualified path on a local volume.

Syntax

HRESULT

GetFullyQualifiedLocalPath(

    [in]           REFGUID Volume,

    [in]           BSTR RelativePath,

    [out, retval]  BSTR* FullPath

)

Parameters

Volume [in]

GUID representing a local volume.  This GUID may not be the FESF Network Volume GUID (FE_NETWORK_GUID) or the FESF Shadow Volume GUID (FE_SHADOW_VOLUME_GUID) and may not be NULL or empty.

RelativePath [in]

A path, relative to the supplied Volume GUID.

FullPath [out, retval]

A pointer to a BSTR into which to store the result on success.

Return value

A standard HRESULT value indicating the success or failure of the lookup operation.

Remarks

Important: This method is deprecated and is pending removal from FESF. Do not use it. Convert existing code that uses it as soon as possible. Use the equivalent function provided by the FesfUtil2 Library.

If the FESF Network Volume GUID (FE_NETWORK_GUID) or the FESF Shadow Volume GUID (FE_SHADOW_VOLUME_GUID) is provided for the Volume argument, the method returns HRESULT E_FAIL.

On return with success, FullPath points to a string holding the fully qualified path for the file on a local volume.  On return with an error status, the contents of FullPath are undefined.

Examples

 

See Also

The provided UM_Sample solution contains examples that illustrate the use of GetFullyQualifiedLocalPath.

 

Requirements

Software version

FESF V1 (or later)

DLL

FESFUtility.DLL

Supported FESF State

FESF Online State

Type Library

\UM_FESF\UMLIB\FESFUTILITY.TLB

IID

IFesfUtil  (please use the defintion from the Type Library)

CLSID

FesfUtil (please use the definition from the Type Library)