Función FltParseFileNameInformation (fltkernel.h)

Artículo
08/07/2023

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, FltGetFileNameInformationUnsafe o FltGetTunneledName. Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

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

Comentarios

FltParseFileNameInformation analiza el miembro Name de una estructura de FLT_FILE_NAME_INFORMATION y usa los resultados para establecer los valores de los miembros Volume, Share, Extension, Stream, FinalComponent, ParentDir y NamesParsed 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"

Recurso compartido: 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:

Volumen: NULL

Recurso compartido: 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.

Nota Si el autor de la llamada intenta analizar una cadena, no una estructura de FLT_FILE_NAME_INFORMATION, use la rutina FltParseFileName en lugar de FltParseFileNameInformation.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows XP SP2 y versiones posteriores del sistema operativo Windows.
Plataforma de destino	Universal
Encabezado	fltkernel.h (incluya Fltkernel.h)
Library	FltMgr.lib
Archivo DLL	Fltmgr.sys
IRQL	<= APC_LEVEL