3.2.4.2.14.11 EnumThresholdActions (Opnum 21)

  • Article

The EnumThresholdActions method enumerates all the actions for the specified threshold.

 [id(FSRM_DISPID_QUOTA_BASE | 0x05)] HRESULT EnumThresholdActions(
   [in] FSRM_QUOTA_THRESHOLD threshold,
   [out, retval] IFsrmCollection** actions
 );

threshold: The threshold for which the associated actions will be enumerated.

actions: Pointer to an IFsrmCollection interface pointer (section 3.2.4.2.1) that upon completion contains IFsrmAction interface pointers (section 3.2.4.2.4) of all the actions for the specified action. The caller MUST release the collection when it is done with it.

To get the specific action interface for the action, the caller MUST call QueryInterface for the interface corresponding to the action type of the actions.

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

An object with the specified threshold could not be found.

0x8004530D

FSRM_E_OUT_OF_RANGE

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

0x80070057

E_INVALIDARG

The actions parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

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

  • Verify that actions is not NULL.

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

The server MUST create a new IFsrmCollection object and populate it with the actions of the specified threshold or return a nonzero error code. If the threshold does not exist for the quota object, the server MUST return FSRM_E_NOT_FOUND.