Функция FltParseFileNameInformation (fltkernel.h)

Статья
08/07/2023

FltParseFileNameInformation анализирует содержимое структуры FLT_FILE_NAME_INFORMATION .

Синтаксис

NTSTATUS FLTAPI FltParseFileNameInformation(
  [in, out] PFLT_FILE_NAME_INFORMATION FileNameInformation
);

Параметры

[in, out] FileNameInformation

Указатель на структуру FLT_FILE_NAME_INFORMATION , возвращенную предыдущим вызовом FltGetDestinationFileNameInformation, FltGetFileNameInformation, FltGetFileNameInformationUnsafe или FltGetTunneledName. Этот параметр является обязательным и не может иметь значение NULL.

Возвращаемое значение

FltParseFileNameInformation возвращает STATUS_SUCCESS или соответствующий код ошибки NTSTATUS.

FltParseFileNameInformation анализирует элемент Name структуры FLT_FILE_NAME_INFORMATION и использует результаты для задания значений элементов Volume, Share, Extension, Stream, FinalComponent, ParentDir и NamesParsed этой структуры. Дополнительные сведения см. в разделе FLT_FILE_NAME_INFORMATION.

Ниже приведен пример нормализованного имени удаленного файла:

\Device\LanManRedirector\MyServer\MyShare\Documents and Settings\MyUser\My Documents\Test Results.txt:stream1

FltParseFileNameInformation анализирует это нормализованное имя следующим образом:

Том: \Device\LanManRedirector

Общий доступ: "\MyServer\MyShare"

Расширение: "txt"

Stream: ":stream1"

FinalComponent: "Test Results.txt:stream1"

ParentDir: "\Documents and Settings\MyUser\My Documents"

Ниже приведен пример открытого имени локального файла:

\Device\HarddiskVolume1\Docume~1\MyUser\My Documents\TestRe~1.txt:stream1:$DATA

FltParseFileNameInformation анализирует это открытое имя следующим образом:

Том: \Device\HarddiskVolume1

Общий ресурс: NULL

Расширение: "txt"

Stream: ":stream1:$DATA"

FinalComponent: "TestRe~1.txt:stream1:$DATA"

ParentDir: "\Docume~1\MyUser\My Documents"

Ниже приведен пример короткого имени файла:

TestRe~1.txt

FltParseFileNameInformation анализирует это короткое имя следующим образом:

Том: NULL

Общий ресурс: NULL

Расширение: "txt"

Stream: NULL

FinalComponent: "TestRe~1.txt"

ParentDir: NULL

Вызывающий объект не должен изменять содержимое структуры FileNameInformation , так как диспетчер фильтров кэширует эту структуру, чтобы ее могли использовать все драйверы минифильтра.

Примечание Если вызывающий объект пытается проанализировать строку, а не структуру FLT_FILE_NAME_INFORMATION, используйте подпрограмму FltParseFileName вместо FltParseFileNameInformation.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows XP с пакетом обновления 2 (SP2) и более поздних версиях операционной системы Windows.
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL