Expand Minimize

FltUntagFile function

FltUntagFile removes a reparse point from a file or directory.

Syntax


NTSTATUS FltUntagFile(
  _In_      PFLT_INSTANCE InitiatingInstance,
  _In_      PFILE_OBJECT FileObject,
  _In_      ULONG FileTag,
  _In_opt_  GUID *Guid
);

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:

Return codeDescription
STATUS_IO_REPARSE_TAG_MISMATCH

The reparse tag specified by the caller did not match the tag of the reparse point to be deleted. This is an error code.

STATUS_REPARSE_ATTRIBUTE_CONFLICT

The reparse GUID specified by the caller did not match the GUID of the reparse point to be deleted. This is an error code.

 

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.

Requirements

Header

Fltkernel.h (include Fltkernel.h)

Library

FltMgr.lib

IRQL

PASSIVE_LEVEL

See also

FLT_TAG_DATA_BUFFER
FltTagFile
FSCTL_DELETE_REPARSE_POINT
FSCTL_GET_REPARSE_POINT
FSCTL_SET_REPARSE_POINT
IsReparseTagMicrosoft
IsReparseTagNameSurrogate

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft