FltParseFileNameInformation 함수(fltkernel.h)

FltParseFileNameInformation 은 FLT_FILE_NAME_INFORMATION 구조체의 내용을 구문 분석합니다.

구문

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

매개 변수

[in, out] FileNameInformation

FltGetDestinationFileNameInformation, FltGetFileNameInformation, FltGetFileNameInformationUnsafe 또는 FltGetTunneledName에 대한 이전 호출에서 반환된 FLT_FILE_NAME_INFORMATION 구조체에 대한 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

반환 값

FltParseFileNameInformation 은 STATUS_SUCCESS 또는 적절한 NTSTATUS 오류 코드를 반환합니다.

설명

FltParseFileNameInformation은 FLT_FILE_NAME_INFORMATION 구조체의 Name 멤버를 구문 분석하고 결과를 사용하여 이 구조체의 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: "테스트 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

FltGetDestinationFileNameInformation

FltGetFileNameInformation

FltGetFileNameInformationUnsafe

FltGetTunneledName

FltParseFileName