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.