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 |