IDiskQuotaControl::SetQuotaState method

Sets the state of the quota system.

Syntax


HRESULT SetQuotaState(
  [in] DWORD dwState
);

Parameters

dwState [in]

State to be applied to the volume. Use the following macros to set the proper bits.

MacroEnableTrackEnforce
DISKQUOTA_SET_DISABLEDNoNoNo
DISKQUOTA_SET_TRACKEDYesYesNo
DISKQUOTA_SET_ENFORCEDYesYesYes

 

Return value

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

Return codeDescription
S_OK

Success.

ERROR_ACCESS_DENIED

The caller has insufficient access rights.

ERROR_NOT_READY

The DiskQuotaControl object is not initialized.

E_INVALIDARG

The dwState parameter is incorrect.

E_OUTOFMEMORY

Insufficient memory.

E_FAIL

An unexpected file system error occurred.

E_UNEXPECTED

An unexpected exception occurred.

 

Remarks

Not all state attributes can be modified. The enable, track, and enforce attributes can be modified.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Dskquota.h

DLL

Dskquota.dll

IID

IID_IDiskQuotaControl is defined as 7988B572-EC89-11cf-9C00-00AA00A14F56

See also

Disk Management Interfaces
Disk Quotas
IDiskQuotaControl

 

 

Show: