Función FltParseFileNameInformation (fltkernel.h)

FltParseFileNameInformation analiza el contenido de una estructura de FLT_FILE_NAME_INFORMATION.

Sintaxis

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

Parámetros

[in, out] FileNameInformation

Puntero a una estructura de FLT_FILE_NAME_INFORMATION devuelta por una llamada anterior a FltGetDestinationFileNameInformation, FltGetFileNameInformation, FltGetFileNameInformationUnsafeo FltGetTunneledName. Este parámetro es necesario y no se puede null.

Valor devuelto

FltParseFileNameInformation devuelve STATUS_SUCCESS o un código de error NTSTATUS adecuado.

Observaciones

FltParseFileNameInformation analiza el miembro Name de de una estructura de FLT_FILE_NAME_INFORMATION y usa los resultados para establecer los valores de Volume, Share, extensión, Stream, FinalComponent, ParentDiry NamesParsed miembros de esta estructura. Para obtener más información, vea FLT_FILE_NAME_INFORMATION.

A continuación se muestra un ejemplo de un nombre normalizado para un archivo remoto:

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

FltParseFileNameInformation analiza este nombre normalizado de la siguiente manera:

Volumen: "\Device\LanManRedirector"

Compartir: "\MyServer\MyShare"

extensión: "txt"

Stream: ":stream1"

FinalComponent: "Test Results.txt:stream1"

ParentDir: "\Documents and Settings\MyUser\My Documents"

A continuación se muestra un ejemplo de un nombre abierto para un archivo local:

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

FltParseFileNameInformation analiza este nombre abierto de la siguiente manera:

Volumen: "\Device\HarddiskVolume1"

Share: NULL

extensión: "txt"

stream: ":stream1:$DATA"

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

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

A continuación se muestra un ejemplo de un nombre corto para un archivo:

TestRe~1.txt

FltParseFileNameInformation analiza este nombre corto de la siguiente manera:

de volumen de: NULL

Share: NULL

extensión: "txt"

stream: NULL

FinalComponent: "TestRe~1.txt"

ParentDir: NULL

El autor de la llamada no debe modificar el contenido de la estructura FileNameInformation, ya que el Administrador de filtros almacena en caché esta estructura para que todos los controladores de minifiltro puedan usarlo.

Requisitos

Consulte también

FLT_FILE_NAME_INFORMATION

FltGetDestinationFileNameInformation

fltGetFileNameInformation

FltGetFileNameInformationUnsafe

FltGetTunneledName

FltParseFileName