Função FltParseFileNameInformation (fltkernel.h)

Artigo
02/26/2024

FltParseFileNameInformation analisa o conteúdo de uma estrutura FLT_FILE_NAME_INFORMATION .

Sintaxe

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

Parâmetros

[in, out] FileNameInformation

Ponteiro para uma estrutura FLT_FILE_NAME_INFORMATION retornada por uma chamada anterior para FltGetDestinationFileNameInformation, FltGetFileNameInformation, FltGetFileNameInformationUnsafe ou FltGetTunneledName. Esse parâmetro é necessário e não pode ser NULL.

Retornar valor

FltParseFileNameInformation retorna STATUS_SUCCESS ou um código de erro NTSTATUS apropriado.

Comentários

FltParseFileNameInformation analisa o membro Name de uma estrutura FLT_FILE_NAME_INFORMATION e usa os resultados para definir os valores dos membros Volume, Share, Extension, Stream, FinalComponent, ParentDir e NamesParsed dessa estrutura. Para obter mais informações, consulte FLT_FILE_NAME_INFORMATION.

Veja a seguir um exemplo de um nome normalizado para um arquivo remoto:

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

FltParseFileNameInformation analisa esse nome normalizado da seguinte maneira:

Volume: "\Device\LanManRedirector"

Compartilhar: "\MyServer\MyShare"

Extensão: "txt"

Stream: ":stream1"

FinalComponent: "Test Results.txt:stream1"

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

Veja a seguir um exemplo de um nome aberto para um arquivo local:

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

FltParseFileNameInformation analisa esse nome aberto da seguinte maneira:

Volume: "\Device\HarddiskVolume1"

Compartilhar: NULL

Extensão: "txt"

Stream: ":stream1:$DATA"

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

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

Veja a seguir um exemplo de um nome curto para um arquivo:

TestRe~1.txt

FltParseFileNameInformation analisa esse nome curto da seguinte maneira:

Volume: NULL

Compartilhar: NULL

Extensão: "txt"

Stream: NULL

FinalComponent: "TestRe~1.txt"

ParentDir: NULL

O chamador não deve modificar o conteúdo da estrutura FileNameInformation , pois o Gerenciador de Filtros armazena essa estrutura em cache para que todos os drivers de minifiltro possam usá-la.

Nota Se o chamador estiver tentando analisar uma cadeia de caracteres, não uma estrutura FLT_FILE_NAME_INFORMATION, use a rotina FltParseFileName em vez de FltParseFileNameInformation.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows XP SP2 e versões posteriores do sistema operacional Windows.
Plataforma de Destino	Universal
Cabeçalho	fltkernel.h (inclua Fltkernel.h)
Biblioteca	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL