Platform SDK: Files and I/O

IDiskQuotaControl::GetQuotaState

Retrieves a set of flags describing the state of the quota system.

HRESULT GetQuotaState(
  LPDWORD pdwState
);
 

Parameters

pdwState
Pointer to a variable to receive the quota state flags. This parameter can be one or more of the following flags.
Flag Meaning
DISKQUOTA_STATE_DISABLED Quotas are not enabled on the volume.
DISKQUOTA_STATE_TRACK Quotas are enabled but the limit value is not being enforced. Users may exceed their quota limit.
DISKQUOTA_STATE_ENFORCE Quotas are enabled and the limit value is enforced. Users cannot exceed their quota limit.
DISKQUOTA_FILESTATE_INCOMPLETE The volume's quota information is out of date. Quotas are probably disabled.
DISKQUOTA_FILESTATE_REBUILDING The volume is rebuilding its quota information.

Return Values

This method returns a file system error or one of the following values.

Value Meaning
NOERROR Success.
ERROR_ACCESS_DENIED The caller has insufficient access rights.
ERROR_NOT_READY The DiskQuotaControl object is not initialized.
E_INVALIDARG The pdwState parameter is incorrect.
E_OUTOFMEMORY Insufficient memory.
E_FAIL An unexpected file system error occurred.
E_UNEXPECTED An unexpected exception occurred.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Dskquota.h.

See Also

File Systems Overview, File System Interfaces, IDiskQuotaControl