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, 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.

Requisitos

Consulte también

FLT_FILE_NAME_INFORMATION

FltGetDestinationFileNameInformation

FltGetFileNameInformation

FltGetFileNameInformationUnsafe

FltGetTunneledName

FltParseFileName