IDiskQuotaControl::GetQuotaState

[This is preliminary documentation and subject to change.]

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 one of the following values.

Value Meaning
S_OK Success.
E_POINTER The pdwState parameter is NULL.
DQC_E_ACCESS_DENIED The caller has insufficient access rights.
E_FAIL Failure reading volume quota information.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in dskquota.h.

See Also

File Systems Overview, File System Interfaces, IDiskQuotaControl