Función IoCheckQuotaBufferValidity (ntifs.h)

  • Artículo

La rutina IoCheckQuotaBufferValidity comprueba si el búfer de cuota especificado es válido.

Sintaxis

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

Parámetros

[in] QuotaBuffer

Puntero al búfer que contiene las entradas de cuota que se van a comprobar.

[in] QuotaLength

Longitud, en bytes, de QuotaBuffer.

[out] ErrorOffset

Variable para recibir el desplazamiento de la entrada incorrecta en el búfer de cuota si se encuentra un error. Esta variable solo es válida si se produce un error.

Valor devuelto

IoCheckQuotaBufferValidity devuelve STATUS_SUCCESS si el búfer de cuota es válido. De lo contrario, devuelve STATUS_DATATYPE_MISALIGNMENT si el búfer de cuota no está alineado con ULONG. Para todos los demás errores, incluida la alineación incorrecta de las entradas en el búfer, IoCheckQuotaBufferValidity devuelve STATUS_QUOTA_LIST_INCONSISTENT.

Comentarios

IoCheckQuotaBufferValidity comprueba cada entrada FILE_QUOTA_INFORMATION en el búfer de cuota especificado para asegurarse de que se cumplen las condiciones siguientes:

  • Toda la entrada debe estar dentro del búfer.

  • El valor de Sid debe ser un identificador de seguridad (SID).

  • El valor de SidLength debe coincidir con la longitud en bytes del valor de Sid.

  • Para todas las entradas excepto la última, el valor de NextEntryOffset debe ser mayor que cero y debe estar en un límite de ULONG.

Además, IoCheckQuotaBufferValidity comprueba el búfer de cuota para asegurarse de que se cumplen las condiciones siguientes:

  • El búfer debe estar alineado con ULONG.

  • La longitud pasada en QuotaLength coincide con la longitud real del búfer.

  • La longitud real del búfer no es negativo.

Para ser válido, el búfer de cuota debe cumplir todas estas condiciones.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000
Plataforma de destino Universal
Encabezado ntifs.h (incluya Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Consulte también

FILE_QUOTA_INFORMATION

IRP_MJ_QUERY_QUOTA

IRP_MJ_SET_QUOTA