3.2.4.2.48.49 CreatePropertyCondition (Opnum 59)

The CreatePropertyCondition method creates a property condition associated with the file management job.

 [id(FSRM_DISPID_FILE_MANAGEMENT_JOB_MANAGER | 0x09)] HRESULT CreatePropertyCondition(
   [in] BSTR name,
   [out, retval] IFsrmPropertyCondition** propertyCondition
 );

name: Contains the name of the property condition to create.

propertyCondition: Pointer to an IFsrmPropertyCondition interface pointer (section 3.2.4.2.49) that upon completion points to the newly created property condition. A caller MUST release the SAFEARRAY received when it is done with it.

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

A property definition with the specified name does not exist.

0x80045303

FSRM_E_ ALREADY_EXISTS

The object already exists.

0x80070057

E_ INVALIDARG

This code is returned for the following reasons:

  • The propertyCondition parameter is NULL.

  • The name parameter does not conform to the requirements for a property definitions name.

Upon receiving this message, the server MUST validate parameters:

  • Verify that propertyCondition is not NULL.

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

The server must perform the following steps:

  • Create a new property condition object and set its parameters as follows:

    • Set Property Condition.Name to name.

    • Set Property Condition.Type to Exists.

    • Set Property Condition.Value to an empty string.

    • Set Property Condition.Parent to this file management job instance.

  • Add the new property condition object to the file management job's Property conditions.