Função FltParseFileNameInformation (fltkernel.h)

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.

Requisitos

Confira também

FLT_FILE_NAME_INFORMATION

FltGetDestinationFileNameInformation

FltGetFileNameInformation

FltGetFileNameInformationUnsafe

FltGetTunneledName

FltParseFileName