Platform SDK: Files and I/O

IDiskQuotaUser::SetQuotaThreshold

Sets the user's warning threshold value on the volume. The threshold is an arbitrary value set by the volume's quota administrator. You can use it to identify users who are approaching their hard quota limit.

HRESULT SetQuotaThreshold(
  LONGLONG llThreshold,
  BOOL fWriteThrough
);

Parameters

llThreshold
Specifies the warning threshold value.
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 the same time.

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_LOCK_FAILED Failure to obtain an exclusive lock.
E_FAIL An unexpected file system error 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, IDiskQuotaUser