Edit

IDiskQuotaUser::SetQuotaLimit method (dskquota.h)

  • Article

Sets the user's quota limit value on the volume. The limit is set as the maximum amount of disk space available to the volume user.

Syntax

HRESULT SetQuotaLimit(
  [in] LONGLONG llLimit,
  [in] BOOL     fWriteThrough
);

Parameters

[in] llLimit

The quota limit, in bytes. If this value is -1, the user has an unlimited quota.

[in] fWriteThrough

If this value is TRUE, the value is written immediately to the volume's quota file. Otherwise, the value is written only to the quota user object's local memory. This value should typically be set to TRUE. Set it to FALSE when using the IDiskQuotaUserBatch interface to modify multiple user quota entries at once.

Return value

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

Return code Description
S_OK
 Success.
ERROR_ACCESS_DENIED
 The caller has insufficient access rights.
ERROR_LOCK_FAILED
 Failure to obtain an exclusive lock.
E_FAIL
 An unexpected file system error occurred.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header dskquota.h
DLL Dskquota.dll

See also

Disk Management Interfaces

Disk Quotas

IDiskQuotaUser