FltUntagFile function

Description

FltUntagFile removes a reparse point from a file or directory.

Parameters

InitiatingInstance [in]

Opaque instance pointer for the minifilter driver instance that initiated this I/O request. This parameter is required and cannot be NULL.

FileObject [in]

Pointer to a file object for the file or directory from which the reparse point is to be removed. The file object must be opened for FILE_WRITE_DATA access. This parameter is required and cannot be NULL.

FileTag [in]

Reparse point tag. The tag specified in this parameter must match the tag of the reparse point to be removed.

Guid [in, optional]

Globally unique identifier (GUID) that uniquely identifies the type of reparse point. If FileTag is not a Microsoft tag, this parameter is required and cannot be NULL. The GUID specified in this parameter must match the GUID of the reparse point to be removed.

Return value

FltUntagFile returns STATUS_SUCCESS or an appropriate NTSTATUS value such as one of the following:

Remarks

Minifilter drivers should use FltUntagFile instead of FSCTL_DELETE_REPARSE_POINT to delete a reparse point.

A minifilter driver can set a reparse tag on a file or directory by calling FltTagFile.

For more information about reparse points, see the Microsoft Windows SDK documentation.

See also

FLT_TAG_DATA_BUFFER

FSCTL_DELETE_REPARSE_POINT

FSCTL_GET_REPARSE_POINT

FSCTL_SET_REPARSE_POINT

FltTagFile

IsReparseTagMicrosoft

IsReparseTagNameSurrogate