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 구조체의 내용을 수정해서는 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP SP2 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | fltkernel.h(Fltkernel.h 포함) |
| 라이브러리 | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
추가 정보
FltGetDestinationFileNameInformation