OV_PropagationRule::Create()
OV_PropagationRule::Create_Trans()
- OV_PropagationRule Create(
- [in] string Caption,
- [in, optional] sint16 DefaultRule,
- [in, optional] sint16 NormalRule,
- [in, optional] sint16 WarningRule,
- [in, optional] sint16 MinorRule,
- [in, optional] sint16 MajorRule,
- [in, optional] sint16 CriticalRule,
- [in, optional] string SettingID,
- [in, optional] string Description)
- OV_PropagationRule Create_Trans(
- [in] string TransId,
- [in] string Caption,
- [in, optional] sint16 DefaultRule,
- [in, optional] sint16 NormalRule,
- [in, optional] sint16 WarningRule,
- [in, optional] sint16 MinorRule,
- [in, optional] sint16 MajorRule,
- [in, optional] sint16 CriticalRule,
- [in, optional] string SettingID,
- [in, optional] string Description)
Parameters
- TransId
- Transaction ID returned from OV_Transaction::Start().
- Caption
- The Caption property of the instance of OV_PropagationRule to
be created. If a propagation rule with the same Caption already
exists, nothing happens, and the method fails with
MDLAPI_E_PROPRULE_CAPTION_EXIST. If the Caption parameter is an
empty string, contains invalid characters, or has more then 1024
characters, the method fails with MDLAPI_E_INVALID_CAPTION.
- DefaultRule
- The DefaultRule property value of this service. Optional
parameter. Default is 0.
- NormalRule
- The NormalRule property value of this service. Optional
parameter. Default is -98.
- WarningRule
- The WarningRule property value of this service. Optional
parameter. Default is -98.
- MinorRule
- The MinorRule property value of this service. Optional
parameter. Default is -98.
- MajorRule
- The MajorRule property value of this service. Optional
parameter. Default is -98.
- CriticalRule
- The CriticalRule property value of this service. Optional
parameter. Default is -98.
- SettingID
- The SettingID property of an instance of the OV_PropagationRule
to be created. Optional parameter. If you do not specify this
parameter, or if it is equal to an empty string, it is created as a
new GUID. If a propagation rule with the same SettingID already
exists, nothing happens, and the method fails with
MDLAPI_E_PROPRULE_SETTINGID_EXISTS.
- Description
- The Description property of the instance of OV_PropagationRule
to be created. Optional parameter.
Calling Convention
These methods can be called from a WMI class or instance
object.
Description
Creates a propagation rule (new instance of
OV_PropagationRule).
If any propagation rule parameter is not valid, the method fails
with MDLAPI_E_INVALID_PARAMETER.
Return Value
Instance of the newly created OV_PropagationRule.
Extended Status Codes
- MDLAPI_E_INVALID_CAPTION
- Specified object Caption parameter is not valid.
- MDLAPI_E_PROPRULE_CAPTION_EXIST
- Propagation rule with the same Caption already exists.
- MDLAPI_E_PROPRULE_SETTINGID_EXISTS
- Propagation rule with the same SettingId already exists.
- MDLAPI_E_INVALID_PARAMETER
- Parameter is not valid.
- MDLAPI_E_TRANSACTION_NOT_EXIST
- Transaction with the specified ID does not exist.