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 obligatorio y no puede ser NULL.

[in, out] Extension

Puntero a una estructura de UNICODE_STRING que recibe la extensión analizada de la cadena FileName . 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.Buffer y Extension.Length recibe la longitud, en bytes, de la extensión. Este parámetro es opcional y puede ser NULL.

[in, out] Stream

Puntero a una estructura de UNICODE_STRING que recibe el nombre de secuencia analizado de la cadena FileName . Si no se encuentra ningún nombre de secuencia, FltParseFileName establece Stream. Búfer en NULL y Stream. Longitud a cero. De lo contrario, Stream. El búfer recibe un puntero al principio del nombre de la secuencia en FileName.Buffer y Stream. Length recibe la longitud, en bytes, del nombre de la secuencia. Este parámetro es opcional y puede ser 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.Buffer y FinalComponent.Length recibe la longitud, en bytes, del componente final. Este parámetro es opcional y puede ser NULL.

Valor devuelto

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

Comentarios

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 de la siguiente manera:

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	Value
Cliente mínimo compatible	Disponible en Windows XP con Service Pack 2 (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

Consulte también

FLT_FILE_NAME_INFORMATION

FltParseFileNameInformation

UNICODE_STRING