Funzione FltUntagFile (fltkernel.h)

Articolo
02/26/2024

FltUntagFile rimuove un punto di ripristino da un file o da 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 di istanza opaco 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 di ripristino. L'oggetto file deve essere aperto per l'accesso FILE_WRITE_DATA. Questo parametro è obbligatorio e non può essere NULL.

[in] FileTag

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

[in, optional] Guid

Identificatore univoco globale (GUID) che identifica in modo univoco il tipo di punto di ripristino. 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 di ripristino 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 di correzione 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 di correzione da eliminare. Si tratta di un codice di errore.

Commenti

I driver minifilter devono usare FltUntagFile anziché FSCTL_DELETE_REPARSE_POINT per eliminare un punto di ripristino.

Un driver minifilter può impostare un tag reparse in un file o in una directory chiamando FltTagFile.

Per altre informazioni sui punti di ripristino, vedere la documentazione di Microsoft Windows SDK.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (includere Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL