The FE_POLICY_PATH_INFORMATION structure specifies the path name for a file being accessed by FESF.
typedef struct _FE_POLICY_PATH_INFORMATION {
LPCWSTR RelativePath;
DWORD PathFlags;
UUID VolumeGuid;
Union {
LPCWSTR ServerAndShare;
LPCWSTR ShadowVolumeName;
};
} FE_POLICY_PATH_INFORMATION;
RelativePath
A path name (including file name), starting with backslash. For local volumes, the path is relative to the volume GUID. For network volumes, the path is relative to the share.
PathFlags
A bitmask containing values describing the location of the path being provided:
|
|
|
|
FE_POLICY_PATH_NAME_NOT_NORMALIZED
|
Indicates that the path information provided has NOT been normalized in format. This is a rare occurrence and relates only to some specific network operations.
|
|
FE_POLICY_PATH_TARGET_NAME_INVALID |
Indicates that the target name could not be established (typically, as a result of a rename across a directory junction point). This flag is only set for PolApproveCreateLink and PolApproveRename callbacks.
|
|
FE_POLICY_PATH_FILE_NAME_BYPASS |
Indicates that the file name (source or target) has been detected as being one which OSR has determined can never be safely encrypted. For example, files used to boot the system or a file that has been part of a recent transaction. These files are termed BYPASS files. The Policy DLL is never involved in the opening of BYPASS files, but a rename of a file from or to a “bypass” name may be of interest to a Policy DLL.
|
|
FE_POLICY_PATH_FILE_DEHYDRATED |
Indicates that a file is being recalled from a Cloud Storage provider (such as OneDrive). This flag will only be set for the PolGetPolicyExistingFIle callback. See the description of that callback for more information.
|
VolumeGuid
For network files, this field contains the GUID FE_NETWORK_GUID.
For shadow volumes, this field contains the GUID FE_SHADOW_VOLUME_GUID.
For local (that is, non-network) volumes, this field contains the GUID representing the local volume on which the file resides. The drive letter that this GUID represents can be translated and combined with the contents of the RelativePath field using the FESF Utility Library function GetFullyQualifiedLocalPath. The result will be a traditional Windows fully qualified path name.
ServerAndShare
The name of the server and share. The UNC file name can be derived by appending the RelativePath to the ServerAndShare.
Only valid if VolumeGuid is FE_NETWORK_GUID.
ShadowVolumeName
The “device name” of the shadow volume. A UNC file name can be derived by appending RelativePath to the ShadowVolumeName and prepending the whole with \\?\GlobalRoot.
Only valid if VolumeGuid is FE_SHADOW_VOLUME_GUID.
|
Software version |
FESF V1 (or later) |
|
Header |
PolDllApi.h |