IDiskQuotaUser::SetQuotaThreshold

[This is preliminary documentation and subject to change.]

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

Value Meaning
S_OK Success.
DQC_E_ACCESS_DENIED The caller has insufficient access rights.
DQC_E_LOCK_FAILED Failure to obtain an exclusive lock.
E_FAIL Failure writing 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, IDiskQuotaUser