Programming Guide |
Creates a named property
int sm_mts_CreateProperty(char *group, char *prop);
group
- Name of group to be created.
prop
- Name of object to be created.
MTS
Server
- 0 Success. The property was created.
- 1 The property previously existed.
- · Otherwise,
PR_E_OBJECT
. The log file will have further error information.
sm_mts_CreateProperty
creates a named property within the specified group. If the group does not exist, it will be created. It is not necessary to call this function as getting or putting a value to a property will automatically create the property if necessary. See sm_mts_GetPropertyValue and sm_mts_PutPropertyValue.The one reason to call this function is to examine the return code. It will be 1 if the property previously existed.
For more details see the CreateProperty method under ISharedPropertyGroup in the MTS documentation.
Note that this function requires an object context and therefore cannot be used in the constructor of a service component.
sm_mts_CreatePropertyGroup, sm_mts_GetPropertyValue, sm_mts_PutPropertyValue