Share via

3.2.4.2.42.3 ExecutionOption (put) (Opnum 25)

  • Article

The ExecutionOption (put) method sets the execution option of the classification rule.

 [propput, id(FSRM_PROPERTY(FSRM_DISPID_CLASSIFICATION_RULE | 0x01))] HRESULT ExecutionOption(
   [in] FsrmExecutionOption executionOption
 );

executionOption: Contains the execution option for this classification rule.

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

Return value/code

Description

0x80070057

E_INVALIDARG

The executionOption parameter is not a valid FsrmExecutionOption (section 2.2.2.5.1.1) value.

Upon receiving this message, the server MUST validate parameters:

  • Verify that executionOption contains valid FsrmExecutionOption (section 2.2.2.5.1.1) values.

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

The server MUST do one of the following:

  • If executionOption contains FsrmExecutionOption_EvaluateUnset, the server MUST apply the rule only to files that do not currently have the property set.

  • If executionOption contains FsrmExecutionOption_ReEvaluate_ConsiderExistingValue, the server MUST compare the rule's value to the file's existing value before adding the resulting value to the file's list of values to be aggregated for this property.

  • If executionOption contains FsrmExecutionOption_ReEvaluate_IgnoreExistingValue, the server MUST ignore the file's existing values of this property and add the rule's value to the file's list of values to be aggregated for this property.