OV_Service::Modify()
OV_Service::Modify_Trans()
- void Modify(
- [in] OV_Service Service)
- void Modify_Trans(
- [in] string TransId,
- [in] OV_Service Service)
Parameters
- TransId
- Transaction ID returned from OV_Transaction::Start().
- Service
- Modified instance of OV_Service to store.
Calling Convention
These methods can be called only from a WMI instance object.
Description
Stores changes performed to one or more properties.
It is not possible to get an instance of OV_Service to reflect
changes to its properties from within
IWbemService::ExecMethodAsync. For this reason, an instance of
OV_Service is specified as the Service parameter, even though this
method is already called in the context of this instance.
As with the OV_ManagedNode::Create method, this method checks
the following:
- If a required property is missing, the method fails with
MDLAPI_E_PROPERTY_MISSING.
- If the Caption property is an empty string, contains invalid
characters, or has more then 1024 characters, the method fails with
MDLAPI_E_INVALID_CAPTION.
- If a property has an invalid value, the method fails with
MDLAPI_E_INVALID_PROPERTY.
- If a service with the same hierarchical path already exists,
the method fails with MDLAPI_E_SERVICE_HIERPATH_EXISTS.
- If graph properties validation fails, the method fails with
MDLAPI_E_GRAPH_PROP_NOT_VALID.
- If report properties validation fails, the method fails with
MDLAPI_E_REPORT_PROP_NOT_VALID.
Return Value
None.
Extended Status Codes
- MDLAPI_E_PROPERTY_MISSING
- Property is not set.
- MDLAPI_E_INVALID_CAPTION
- Specified object Caption parameter is not valid.
- MDLAPI_E_INVALID_PROPERTY
- Property is not valid.
- MDLAPI_E_SERVICE_HIERPATH_EXISTS
- Service with the same Caption is already a child of the parent
service.
- MDLAPI_E_INVALID_CONFIG_VALUE
- Configuration value is not valid.
- MDLAPI_E_NO_REPORT_INTEGRATION
- Reporter integration tool is not installed.
- MDLAPI_E_NO_GRAPH_INTEGRATION
- Performance Manager integration tool is not installed.
- MDLAPI_E_GRAPH_PROP_NOT_VALID
- Graph properties (GraphFamily and GraphCategory) are not
valid.
- MDLAPI_E_REPORT_PROP_NOT_VALID
- Report properties (ReportFamily and ReportCategory) are not
valid.
- MDLAPI_E_TRANSACTION_NOT_EXIST
- Transaction with the specified ID does not exist.