Funzione IoCheckQuotaBufferValidity (ntifs.h)
La routine IoCheckQuotaBufferValidity controlla se il buffer di quota specificato è valido.
NTSTATUS IoCheckQuotaBufferValidity(
[in] PFILE_QUOTA_INFORMATION QuotaBuffer,
[in] ULONG QuotaLength,
[out] PULONG ErrorOffset
);
[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 che causa l'errore nel buffer della quota se viene trovato un errore. Questa variabile è valida solo se si verifica un errore.
IoCheckQuotaBufferValidity restituisce STATUS_SUCCESS se il buffer della quota è valido. In caso contrario, restituisce STATUS_DATATYPE_MISALIGNMENT se il buffer delle quote non è allineato a ULONG. Per tutti gli altri errori, incluso il disallineamento delle voci nel buffer, IoCheckQuotaBufferValidity restituisce STATUS_QUOTA_LIST_INCONSISTENT.
IoCheckQuotaBufferValidity controlla ogni voce FILE_QUOTA_INFORMATION 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 SID (Security Identifier).
Il valore di SidLength deve corrispondere alla lunghezza in byte del valore di Sid.
Per tutte le voci tranne l'ultima, il valore di NextEntryOffset deve essere maggiore di zero e deve essere compreso in un limite ULONG.
Inoltre, IoCheckQuotaBufferValidity controlla il buffer delle quote per assicurarsi che siano 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 è negativo.
Per essere valido, il buffer delle quote deve soddisfare tutte queste condizioni.
| 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 |