Функция FltParseFileNameInformation (fltkernel.h)
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 , так как диспетчер фильтров кэширует эту структуру, чтобы ее могли использовать все драйверы минифильтра.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно в Windows XP с пакетом обновления 2 (SP2) и более поздних версиях операционной системы Windows. |
Целевая платформа | Универсальное |
Верхняя часть | fltkernel.h (включая Fltkernel.h) |
Библиотека | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |
См. также раздел
FltGetDestinationFileNameInformation