FltQueryQuotaInformationFile 함수(fltkernel.h)
FltQueryQuotaInformationFile 루틴은 파일 개체와 연결된 할당량 항목을 검색합니다.
통사론
NTSTATUS FLTAPI FltQueryQuotaInformationFile(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID Buffer,
[in] ULONG Length,
[in] BOOLEAN ReturnSingleEntry,
[in, optional] PVOID SidList,
[in] ULONG SidListLength,
[in, optional] PULONG StartSid,
[in] BOOLEAN RestartScan,
[out, optional] PULONG LengthReturned
);
매개 변수
[in] Instance
호출자에 대한 불투명 인스턴스 포인터입니다. 이 매개 변수는 필수이며 NULL 수 없습니다.
[in] FileObject
열려 있는 파일, 디렉터리, 스토리지 디바이스 또는 볼륨에 대한 파일 개체 포인터입니다. 이 매개 변수는 필수이며 NULL 수 없습니다.
[out] IoStatusBlock
FltQueryQuotaInformationFile호출 결과를 수신하기 위한 호출자 제공 IO_STATUS_BLOCK. 잘못된 SID 목록으로 인해 호출이 실패하면 정보 필드에 오류가 발생한 SidList 위치가 포함됩니다.
[out] Buffer
할당량 정보 값을 반환할 호출자 제공 FILE_GET_QUOTA_INFORMATION구조적 입력 버퍼에 대한 포인터입니다.
[in] Length
Buffer 매개 변수가 가리키는 버퍼의 길이(바이트)입니다.
[in] ReturnSingleEntry
FltQueryQuotaInformationFile 첫 번째 항목만 반환해야 하는 경우 true 설정합니다.
[in, optional] SidList
쿼리할 할당량 정보를 지정하는 호출자 제공 FILE_GET_QUOTA_INFORMATION구조적 입력 버퍼에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다.
[in] SidListLength
SidList 매개 변수가 가리키는 버퍼의 길이(바이트)입니다.
[in, optional] StartSid
파일의 할당량 정보 목록 검사를 시작할 항목의 인덱스입니다. 이 매개 변수는 SidList 매개 변수가 없음 목록을 가리키는 경우 무시됩니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다.
[in] RestartScan
FltQueryQuotaInformationFile 파일의 할당량 정보 목록의 첫 번째 항목에서 검사를 시작해야 하는 경우 TRUE 설정합니다. 이 매개 변수가 TRUE 설정되지 않은 경우 이전 호출에서 fltQueryQuotaInformationFile 검색이 다시 시작됩니다.
[out, optional] LengthReturned
Buffer반환된 정보의 크기(바이트)를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다.
반환 값
FltQueryQuotaInformationFile STATUS_SUCCESS 또는 다음과 같은 적절한 NTSTATUS 값을 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
|
인스턴스 또는 볼륨이 축소되고 있습니다. 오류 코드입니다. |
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8부터 사용할 수 있습니다. |
| 대상 플랫폼 | 보편적 |
| 헤더 | fltkernel.h(Fltkernel.h 포함) |
| 라이브러리 | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |