Share via

3.2.4.2.14.9 ModifyThreshold (Opnum 19)

  • Article

The ModifyThreshold method modifies the disk usage percentage of an existing threshold in the quota object's list of thresholds.

 [id(FSRM_DISPID_QUOTA_BASE | 0x03)] HRESULT ModifyThreshold(
   [in] FSRM_QUOTA_THRESHOLD threshold,
   [in] FSRM_QUOTA_THRESHOLD newThreshold
 );

threshold: Contains the value of the threshold to modify.

newThreshold: Contains the new value of the threshold.

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80045301

FSRM_E_NOT_FOUND

No threshold was found on the quota object equal to the value specified in the threshold parameter.

0x80045303

FSRM_E_ALREADY_EXISTS

A threshold equal to the newThreshold parameter already exists for the quota object.

0x8004530D

FSRM_E_OUT_OF_RANGE

The content of the threshold parameter is less than 1 or greater than 250.

Upon receiving this message, the server MUST validate parameters:

  • Verify that threshold is greater than 0 and less than 251.

  • Verify that newThreshold is greater than 0 and less than 251.

If any validation fails, the server MUST terminate processing and return a nonzero error code.

The server MUST modify the quota object's entry for threshold to use newThreshold or return a nonzero error code. If the threshold does not exist for the quota object, the server MUST return FSRM_E_NOT_FOUND.