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.