Funzione FltDeleteFileContext (fltkernel.h)

Articolo
08/07/2023

La routine FltDeleteFileContext recupera ed elimina un contesto di file impostato da un determinato driver minifilter per un determinato file.

Sintassi

NTSTATUS FLTAPI FltDeleteFileContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *OldContext
);

Parametri

[in] Instance

Puntatore dell'istanza opaca per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

[in] FileObject

Puntatore a oggetti file per il file. Questo parametro è obbligatorio e non può essere NULL.

[out] OldContext

Puntatore a una variabile allocata dal chiamante che riceve l'indirizzo del contesto eliminato. Se non viene trovato alcun contesto corrispondente, questa variabile riceve NULL_CONTEXT. Questo parametro è facoltativo e può essere NULL. Per altre informazioni su questo parametro, vedere la sezione Osservazioni seguente.

Valore restituito

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

Codice restituito	Descrizione
STATUS_NOT_FOUND	Non è stato trovato alcun contesto corrispondente. Si tratta di un codice di errore.
STATUS_NOT_SUPPORTED	I contesti di file non sono supportati per questo file. Si tratta di un codice di errore.

Commenti

Per altre informazioni sui contesti, vedere Informazioni sui contesti minifilter.

Poiché i contesti vengono conteggiati dai riferimenti, non è in genere necessario per un driver minifilter chiamare una routine come FltDeleteFileContext o FltDeleteContext per eliminare in modo esplicito un contesto.

Un driver minifilter chiama FltDeleteFileContext per recuperare ed eliminare un contesto di file impostato in precedenza per un file chiamando FltSetFileContext.

Se il parametro OldContext è NULL nell'input e viene trovato un contesto di file corrispondente, FltDeleteFileContext rilascia il riferimento aggiunto dalla chiamata precedente del driver minifilter a FltSetFileContext. Il contesto eliminato viene in genere liberato immediatamente, a meno che non vi sia un riferimento in sospeso, ad esempio perché il contesto è ancora in uso da un altro thread.

Se il parametro OldContext non è NULL e viene trovato e restituito un contesto di file corrispondente, il chiamante è responsabile del rilascio del riferimento aggiunto da FltSetFileContext. Per rilasciare questo riferimento, il driver minifilter deve chiamare FltReleaseContext nel contesto di file eliminato appena possibile dopo aver eseguito la pulizia necessaria.

Per allocare un nuovo contesto, chiamare FltAllocateContext.

Per determinare se i contesti di file sono supportati per un determinato file, chiamare FltSupportsFileContexts o FltSupportsFileContextsEx.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista e versioni successive
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (include Fltkernel.h)
Libreria	FltMgr.lib
IRQL	<= APC_LEVEL