ReadHeaderUnsafe and ReadHeaderUnsafeFQP methods

This method is deprecated.

Provides a mechanism to read the header of an encrypted file, even if the file is currently in use by another process.

Syntax

HRESULT

ReadHeaderUnsafe(

  [in] REFGUID VolumeGuid,

  [in] BSTR RelativePath,

        [out, retval] VARIANT *Header

)

HRESULT

ReadHeaderUnsafeFQP(

  [in] BSTR Fqp,

  [out, retval] VARIANT *Header

)

Parameters

VolumeGuid [in]

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

RelativePath [in]

A path, relative to the supplied Volume GUID.

FQP [in]

A Fully Qualified (Windows) Path to a file on a local volume. File must not be located on a network share.

Header [out, retval]

The current file header.

Return value

If the method succeeds, S_OK is returned.

If the method fails for any reason, an appropriate error code is returned.

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.

The file must be FESF encrypted and the caller must have SeRestorePrivilege.

Examples

See Also

Requirements