Función ZwSetQuotaInformationFile (ntifs.h)

Artículo
12/21/2024

El ZwSetQuotaInformationFile rutina cambia las entradas de cuota del volumen asociado al parámetro fileHandle . Todas las entradas de cuota del búfer especificado se aplican al volumen.

Sintaxis

NTSYSAPI NTSTATUS ZwSetQuotaInformationFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

Parámetros

[in] FileHandle

Identificador del objeto de archivo que representa el archivo o volumen para el que se va a modificar la información de cuota.

[out] IoStatusBlock

Dirección del bloque de estado de E/S del autor de la llamada.

[in] Buffer

Búfer que contiene las nuevas entradas de cuota que se deben aplicar al volumen. La información de cuota debe tener el formato de una o varias estructuras FILE_QUOTA_INFORMATION. El campo NextEntryOffset de la estructura FILE_QUOTA_INFORMATION contiene el desplazamiento, en bytes, de la siguiente entrada de cuota de la lista. Si no hay más entradas después de la actual, este miembro es cero.

[in] Length

Longitud en bytes del búfer.

Valor devuelto

La rutina ZwSetQuotaInformationFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_INSUFFICIENT_RESOURCES	No había recursos suficientes para completar la operación. Se trata de un código de error.
STATUS_INVALID_DEVICE_REQUEST	Las cuotas no están habilitadas en el volumen. Se trata de un código de error.
STATUS_MEDIA_WRITE_PROTECTED	El volumen es de solo lectura. Se trata de un código de error.

Observaciones

La rutina ZwSetQuotaInformationFile aplica todas las entradas de cuota del parámetro Buffer especificado al volumen.

La función IoCheckQuotaBufferValidity puede comprobar si el búfer de cuota especificado pasado como buffer de parámetro es válido.

Una llamada a ZwSetQuotaInformationFile provocará que se envíe una solicitud IRP_MJ_SET_QUOTA al objeto de dispositivo asociado al objeto de archivo cuyo identificador se almacena en el parámetro FileHandle.

Si el sistema de archivos subyacente no admite información de cuota (sistemas de archivos FAT y CDFS, por ejemplo), ZwSetQuotaInformationFile producirá un error al devolver STATUS_INVALID_DEVICE_REQUEST.

Nota

Si la llamada a la función ZwSetQuotaInformationFile se produce en modo de usuario, debe usar el nombre "NtSetQuotaInformationFile" en lugar de "ZwSetQuotaInformationFile".

En el caso de las llamadas desde controladores en modo kernel, las NtXxx y Zwversiones de Xxx de una rutina de Servicios del sistema nativo de Windows pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones de NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 7
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h, FltKernel.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)