Funzione FltIsDirectory (fltkernel.h)

Articolo
02/06/2025

Un driver minifiltro chiama la routine FltIsDirectory per determinare se un determinato oggetto file rappresenta una directory.

Sintassi

NTSTATUS FLTAPI FltIsDirectory(
  [in]  PFILE_OBJECT  FileObject,
  [in]  PFLT_INSTANCE Instance,
  [out] PBOOLEAN      IsDirectory
);

Parametri

[in] FileObject

Puntatore a un oggetto file già aperto.

[in] Instance

Puntatore a istanze opache per l'istanza associata a questo oggetto file.

[out] IsDirectory

Puntatore a una variabile booleana fornita dal chiamante. In caso contrario, questa variabile riceve TRUE se l'oggetto file rappresenta una directory, FALSE in caso contrario.

Valore restituito

FltIsDirectory restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio:

Codice restituito	Descrizione
STATUS_NOT_SUPPORTED	Questo codice di errore viene restituito se il file system non supporta i contesti di flusso. Si noti che a partire da Windows Vista, FltIsDirectory restituirà informazioni sulla directory anche per i file system che non supportano i contesti di flusso.

Osservazioni

FltIsDirectory recupera le informazioni desiderate dal gestore del contesto di flusso interno del gestore filtri. Gestione filtri memorizza nella cache queste informazioni per le query future su questo flusso.

Nota Questa routine può essere chiamata solo su un oggetto file aperto.

Fabbisogno

Requisito	Valore
client minimo supportato	Questa routine è disponibile in Microsoft Windows 2000 Update Rollup 1 per SP4, Windows XP SP2, Microsoft Windows Server 2003 SP1 e versioni successive. Si noti che questa routine non è disponibile in Windows 2000 SP4 o versioni precedenti.
piattaforma di destinazione	Universale
intestazione	fltkernel.h (include FltKernel.h)
libreria	Fltmgr.lib
dll	Fltmgr.sys
IRQL	<= APC_LEVEL

Vedere anche

FsRtlSupportsPerStreamContexts

Condividi tramite