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

호출자에 대한 불투명 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

버퍼에 반환된 정보의 크기(바이트)를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

반환 값

FltQueryQuotaInformationFile 은 STATUS_SUCCESS 또는 다음과 같은 적절한 NTSTATUS 값을 반환합니다.

요구 사항

추가 정보

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile