FltQueryEaFile 함수(fltkernel.h)
FltQueryEaFile 은 파일에 대한 EA(확장 특성) 값에 대한 정보를 반환합니다.
구문
NTSTATUS FLTAPI FltQueryEaFile(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PVOID ReturnedEaData,
[in] ULONG Length,
[in] BOOLEAN ReturnSingleEntry,
[in, optional] PVOID EaList,
[in] ULONG EaListLength,
[in, optional] PULONG EaIndex,
[in] BOOLEAN RestartScan,
[out, optional] PULONG LengthReturned
);
매개 변수
[in] Instance
QueryEa 작업을 보낼 미니필터 드라이버 instance 대한 불투명 instance 포인터입니다. instance 파일이 있는 볼륨에 연결해야 합니다.
[in] FileObject
파일에 대한 파일 개체 포인터입니다.
[out] ReturnedEaData
확장 특성 값이 반환될 호출자가 제공하는 FILE_FULL_EA_INFORMATION 구조화된 입력 버퍼에 대한 포인터입니다.
[in] Length
ReturnedEaData 매개 변수가 가리키는 버퍼의 길이(바이트)입니다.
[in] ReturnSingleEntry
FltQueryEaFile이 발견된 첫 번째 항목만 반환해야 하는 경우 TRUE로 설정합니다.
[in, optional] EaList
쿼리할 확장 특성을 지정하는 호출자가 제공하는 FILE_GET_EA_INFORMATION 구조화된 입력 버퍼에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in] EaListLength
EaList 매개 변수가 가리키는 버퍼의 길이(바이트)입니다.
[in, optional] EaIndex
파일의 확장 특성 목록 검사를 시작할 항목의 인덱스입니다. EaList 매개 변수가 없음 목록을 가리키는 경우 이 매개 변수는 무시됩니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
[in] RestartScan
FltQueryEaFile이 파일의 확장 특성 목록의 첫 번째 항목에서 검사를 시작해야 하는 경우 TRUE로 설정합니다. 이 매개 변수가 TRUE로 설정되지 않은 경우 FltQueryEaFile에 대한 이전 호출에서 검사가 다시 시작됩니다.
[out, optional] LengthReturned
ReturnedEaData 버퍼에 반환된 정보의 크기(바이트)를 수신하는 호출자가 할당한 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.
반환 값
FltQueryEaFile 은 STATUS_SUCCESS 또는 다음과 같은 적절한 NTSTATUS 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
파일 시스템은 확장 특성을 지원하지 않습니다. 오류 코드입니다. |
|
instance 또는 볼륨이 분해되고 있습니다. 오류 코드입니다. |
|
FltQueryEaFile 에서 풀 할당 오류가 발생했습니다. 오류 코드입니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Sp4, Windows XP SP3, Windows Server 2003 SP1 이상 버전의 Windows 운영 체제용 Microsoft Windows 2000 업데이트 롤업 1에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | fltkernel.h(Fltkernel.h 포함) |
| 라이브러리 | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |