Funzione IoCheckQuotaBuffer Validità (ntifs.h)

La routine IoCheckQuotaBuffer Validità verifica se il buffer di quota specificato è valido.

Sintassi

NTSTATUS IoCheckQuotaBufferValidity(
  [in]  PFILE_QUOTA_INFORMATION QuotaBuffer,
  [in]  ULONG                   QuotaLength,
  [out] PULONG                  ErrorOffset
);

Parametri

[in] QuotaBuffer

Puntatore al buffer contenente le voci di quota da controllare.

[in] QuotaLength

Lunghezza, in byte, di QuotaBuffer.

[out] ErrorOffset

Variabile per ricevere l'offset della voce in caso di errore nel buffer di quota se viene trovato un errore. Questa variabile è valida solo se si verifica un errore.

Valore restituito

IoCheckQuotaBuffer Validità restituisce STATUS_SUCCESS se il buffer di quota è valido. In caso contrario, restituisce STATUS_DATATYPE_MISALIGNMENT se il buffer di quota non è allineato a ULONG. Per tutti gli altri errori, incluso il non allineamento delle voci nel buffer, IoCheckQuotaBuffer Validità restituisce STATUS_QUOTA_LIST_INCONSISTENT.

Commenti

IoCheckQuotaBuffer Validità controlla ogni FILE_QUOTA_INFORMATION voce nel buffer di quota specificato per assicurarsi che vengano soddisfatte le condizioni seguenti:

  • L'intera voce deve rientrare nel buffer.

  • Il valore di Sid deve essere un identificatore di sicurezza (SID).

  • Il valore di SidLength deve corrispondere alla lunghezza in byte del valore di Sid.

  • Per tutte le voci tranne l'ultimo, il valore di NextEntryOffset deve essere maggiore di zero e deve cadere su un limite ULONG.

Inoltre, IoCheckQuotaBuffer Validità controlla il buffer delle quote per assicurarsi che vengano soddisfatte le condizioni seguenti:

  • Il buffer deve essere allineato a ULONG.

  • La lunghezza passata in QuotaLength corrisponde alla lunghezza effettiva del buffer.

  • La lunghezza effettiva del buffer non è effettiva.

Per essere valido, il buffer delle quote deve soddisfare tutte queste condizioni.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Vedi anche

FILE_QUOTA_INFORMATION

IRP_MJ_QUERY_QUOTA

IRP_MJ_SET_QUOTA