This method is deprecated.
Converts a Volume GUID and Relative Path pair into a sting containing a fully qualified path on a local volume.
HRESULT
GetFullyQualifiedLocalPath(
[in] REFGUID Volume,
[in] BSTR RelativePath,
[out, retval] BSTR* FullPath
)
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.
A standard HRESULT value indicating the success or failure of the lookup operation.
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.
The provided UM_Sample solution contains examples that illustrate the use of GetFullyQualifiedLocalPath.
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) |