3.2.4.2.42.7 Value (put) (Opnum 29)

  • Article

The Value (put) method sets the value applied by the rule.

 [propput, id(FSRM_PROPERTY(FSRM_DISPID_CLASSIFICATION_RULE | 0x03))] HRESULT Value(
   [in] BSTR value
 );

value: Contains the value applied by the 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 content of the value parameter exceeds the maximum length of 1,000 characters.

Upon receiving this message, the server MUST validate parameters:

  • If the module definition used by the rule has needs explicit value set to true, verify that value contains valid data for the Property Definition.Type specified by PropertyAffected (put) (section 3.2.4.2.42.5).

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

 The server MUST use value as the Rule.Value applied by the rule. The server MUST NOT allow the client to persist the classification rule if value is set and the module definition used by the rule has needs explicit value set to false.