Función FltUntagFile (fltkernel.h)

Artículo
02/06/2025

FltUntagFile quita un punto de reanálisis de un archivo o directorio.

Sintaxis

NTSTATUS FLTAPI FltUntagFile(
  [in]           PFLT_INSTANCE InitiatingInstance,
  [in]           PFILE_OBJECT  FileObject,
  [in]           ULONG         FileTag,
  [in, optional] GUID          *Guid
);

Parámetros

[in] InitiatingInstance

Puntero de instancia opaco para la instancia del controlador de minifiltro que inició esta solicitud de E/S. Este parámetro es necesario y no se puede null.

[in] FileObject

Puntero a un objeto de archivo para el archivo o directorio desde el que se va a quitar el punto de reanálisis. El objeto de archivo debe abrirse para FILE_WRITE_DATA acceso. Este parámetro es necesario y no se puede null.

[in] FileTag

Etiqueta de punto de reanálisis. La etiqueta especificada en este parámetro debe coincidir con la etiqueta del punto de reanálisis que se va a quitar.

[in, optional] Guid

Identificador único global (GUID) que identifica de forma única el tipo de punto de reanálisis. Si FileTag no es una etiqueta de Microsoft, este parámetro es necesario y no se puede NULL. El GUID especificado en este parámetro debe coincidir con el GUID del punto de reanálisis que se va a quitar.

Valor devuelto

fltUntagFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_IO_REPARSE_TAG_MISMATCH	La etiqueta de reanálisis especificada por el autor de la llamada no coincide con la etiqueta del punto de reanálisis que se va a eliminar. Se trata de un código de error.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	El GUID de reanálisis especificado por el autor de la llamada no coincide con el GUID del punto de reanálisis que se va a eliminar. Se trata de un código de error.

Observaciones

Los controladores de minifiltro deben usar FltUntagFile en lugar de FSCTL_DELETE_REPARSE_POINT para eliminar un punto de reanálisis.

Un controlador de minifiltro puede establecer una etiqueta de reanálisis en un archivo o directorio llamando a FltTagFile.

Para obtener más información sobre los puntos de reanálisis, consulte la documentación del SDK de Microsoft Windows.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	fltkernel.h (incluya Fltkernel.h)
biblioteca de	FltMgr.lib
DLL de	Fltmgr.sys
irQL	PASSIVE_LEVEL