Función FltUntagFile (fltkernel.h)

Artículo
02/26/2024

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 obligatorio y no puede ser NULL.

[in] FileObject

Puntero a un objeto de archivo para el archivo o directorio del 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 obligatorio y no puede ser 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 obligatorio y no puede ser 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.