3.2.4.2.4.4 RunLimitInterval (put) (Opnum 10)

The RunLimitInterval (put) method sets the run limit interval for the object.

 [propput, id(FSRM_PROPERTY(FSRM_DISPID_ACTION | 0x03))] HRESULT RunLimitInterval(
   [in] long minutes
 );

minutes: Contains the run limit interval to use for this action.

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

Return value/code

Description

0x80070057

E_INVALIDARG

The minutes parameter is not a valid value; it must be greater than -2.

Upon receiving this message, the server MUST validate parameters:

  • Verify that minutes is greater than -2.

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

The server MUST use minutes as the run limit interval for this action.

When determining if an action MUST be run, the server MUST do the following:

  • If minutes is -1, the server MUST use the general setting's run limit interval for this type of action (SetActionRunLimitInterval (section 3.2.4.2.11.12)).

  • If minutes is 0, the server MUST run the action for each quota or file screen event.

  • If minutes is greater than 0, the server MUST wait for the specified number of minutes before running the same action for a quota or file screen event on the same disk directory path.