Funzione FltParseFileNameInformation (fltkernel.h)

Articolo
02/29/2024

FltParseFileNameInformation analizza il contenuto di una struttura FLT_FILE_NAME_INFORMATION .

Sintassi

NTSTATUS FLTAPI FltParseFileNameInformation(
  [in, out] PFLT_FILE_NAME_INFORMATION FileNameInformation
);

Parametri

[in, out] FileNameInformation

Puntatore a una struttura FLT_FILE_NAME_INFORMATION restituita da una chiamata precedente a FltGetDestinationFileNameInformation, FltGetFileNameInformation, FltGetFileNameInformationUnsafe o FltGetTunneledName. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

FltParseFileNameInformation restituisce STATUS_SUCCESS o un codice di errore NTSTATUS appropriato.

Commenti

FltParseFileNameInformation analizza il membro Name di una struttura FLT_FILE_NAME_INFORMATION e usa i risultati per impostare i valori del volume, condivisione,estensione, Stream, FinalComponent, ParentDir e NamesParsed membri di questa struttura. Per altre informazioni, vedere FLT_FILE_NAME_INFORMATION.

Di seguito è riportato un esempio di nome normalizzato per un file remoto:

\Device\LanManRedirector\MyServer\MyShare\Documents and Settings\MyUser\My Documents\Test Results.txt:stream1

FltParseFileNameInformation analizza questo nome normalizzato come indicato di seguito:

Volume: "\Device\LanManRedirector"

Condividi: "\MyServer\MyShare"

Estensione: "txt"

Stream: ":stream1"

FinalComponent: "Test Results.txt:stream1"

ParentDir: "\Documenti e impostazioni\MyUser\My Documents"

Di seguito è riportato un esempio di nome aperto per un file locale:

\Device\HarddiskVolume1\Docume~1\MyUser\My Documents\TestRe~1.txt:stream1:$DATA

FltParseFileNameInformation analizza questo nome aperto come indicato di seguito:

Volume: "\Device\HarddiskVolume1"

Condivisione: NULL

Estensione: "txt"

Stream: ":stream1:$DATA"

FinalComponent: "TestRe~1.txt:stream1:$DATA"

ParentDir: "\Docume~1\MyUser\My Documents"

Di seguito è riportato un esempio di nome breve per un file:

TestRe~1.txt

FltParseFileNameInformation analizza questo breve nome come indicato di seguito:

Volume: NULL

Condivisione: NULL

Estensione: "txt"

Stream: NULL

FinalComponent: "TestRe~1.txt"

ParentDir: NULL

Il chiamante non deve modificare il contenuto della struttura FileNameInformation , perché Filter Manager memorizza nella cache questa struttura in modo che tutti i driver minifilter possano usarli.

Nota Se il chiamante sta tentando di analizzare una stringa, non una struttura FLT_FILE_NAME_INFORMATION, usare la routine FltParseFileName anziché FltParseFileNameInformation.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows XP SP2 e versioni successive del sistema operativo Windows.
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (includere Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL