Función FltParseFileName (fltkernel.h)

FltParseFileName analiza la extensión, la secuencia y el componente final de una cadena de nombre de archivo.

Sintaxis

NTSTATUS FLTAPI FltParseFileName(
  [in]      PCUNICODE_STRING FileName,
  [in, out] PUNICODE_STRING  Extension,
  [in, out] PUNICODE_STRING  Stream,
  [in, out] PUNICODE_STRING  FinalComponent
);

Parámetros

[in] FileName

Puntero a una estructura de UNICODE_STRING que contiene la cadena que se va a analizar como un nombre de archivo. Este parámetro es necesario y no se puede null.

[in, out] Extension

Puntero a una estructura de UNICODE_STRING que recibe la extensión analizada de la cadena FileName de. Si no se encuentra ninguna extensión, FltParseFileName establece Extension.Buffer en NULL y Extension.Length en cero. De lo contrario, Extension.Buffer recibe un puntero al principio de la extensión en FileName.Buffery Extension.Length recibe la longitud, en bytes, de la extensión. Este parámetro es opcional y se puede NULL.

[in, out] Stream

Puntero a una estructura de UNICODE_STRING que recibe el nombre de secuencia analizado de la cadena FileName de. Si no se encuentra ningún nombre de secuencia, FltParseFileName establece Stream.Buffer en NULL y Stream.Length en cero. De lo contrario, Stream.Buffer recibe un puntero al principio del nombre de la secuencia en FileName.Buffery Stream.Length recibe la longitud, en bytes, del nombre de la secuencia. Este parámetro es opcional y se puede NULL.

[in, out] FinalComponent

Puntero a una estructura de UNICODE_STRING que recibe el componente de nombre final analizado de la cadena FileName. Si no se encuentra ningún componente final, FltParseFileName establece FinalComponent.Buffer en NULL y FinalComponent.Length en cero. De lo contrario, FinalComponent.Buffer recibe un puntero al principio del componente final en FileName.Buffery FinalComponent.Length recibe la longitud, en bytes, del componente final. Este parámetro es opcional y se puede NULL.

Valor devuelto

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

Observaciones

FltParseFileName analiza la extensión, el nombre de la secuencia y el componente final de una cadena de nombre de archivo. No es necesario normalizar el nombre de archivo ni un nombre de ruta de acceso completo. Si el nombre de archivo es un nombre de archivo corto, FltParseFileName analiza solo la extensión.

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

\Device\HarddiskVolume1\Documents and Settings\MyUser\My Documents\Test Results.txt:stream1

FltParseFileName analiza este nombre normalizado de la siguiente manera:

extensión: "txt"

Stream: ":stream1"

FinalComponent: "Test Results.txt:stream1"

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

TestRe~1.txt

FltParseFileName analiza este nombre corto como se indica a continuación:

extensión: "txt"

stream: NULL

FinalComponent: "TestRe~1.txt"

Para obtener más información sobre la normalización del nombre de archivo y el análisis de nombres de archivo, consulte FLT_FILE_NAME_INFORMATION.

Para analizar el contenido de una estructura de FLT_FILE_NAME_INFORMATION, llame a FltParseFileNameInformation.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows XP con Service Pack 2 (SP2) y versiones posteriores del sistema operativo Windows.
de la plataforma de destino de	Universal
encabezado de	fltkernel.h (incluya Fltkernel.h)
biblioteca de	FltMgr.lib
DLL de	Fltmgr.sys
irQL	<= APC_LEVEL

Consulte también

FLT_FILE_NAME_INFORMATION

FltParseFileNameInformation

UNICODE_STRING