Funzione FltUntagFile (fltkernel.h)

Articolo
02/06/2025

FltUntagFile rimuove un reparse point da un file o una directory.

Sintassi

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

Parametri

[in] InitiatingInstance

Puntatore a istanze opache per l'istanza del driver minifilter che ha avviato questa richiesta di I/O. Questo parametro è obbligatorio e non può essere NULL.

[in] FileObject

Puntatore a un oggetto file per il file o la directory da cui deve essere rimosso il punto reparse. L'oggetto file deve essere aperto per l'accesso FILE_WRITE_DATA. Questo parametro è obbligatorio e non può essere NULL.

[in] FileTag

Tag del punto di ripristino. Il tag specificato in questo parametro deve corrispondere al tag del punto reparse da rimuovere.

[in, optional] Guid

Identificatore univoco globale (GUID) che identifica in modo univoco il tipo di reparse point. Se FileTag non è un tag Microsoft, questo parametro è obbligatorio e non può essere NULL. Il GUID specificato in questo parametro deve corrispondere al GUID del punto reparse da rimuovere.

Valore restituito

FltUntagFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_IO_REPARSE_TAG_MISMATCH	Il tag reparse specificato dal chiamante non corrisponde al tag del punto reparse da eliminare. Si tratta di un codice di errore.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Il GUID reparse specificato dal chiamante non corrisponde al GUID del punto reparse da eliminare. Si tratta di un codice di errore.