OV_Action::Modify()
OV_Action::Modify_Trans()

void Modify(: [in] OV_Action Action)
void Modify_Trans(: [in] string TransId,; [in] OV_Action Action)

Parameters

TransId: Transaction ID returned from OV_Transaction::Start().
Action: Modifies an instance of OV_Action to store.

Calling Convention

These methods can be called only from a WMI instance object.

Description

Stores changes made to one or more properties.

It is not possible to get an instance of OV_Action to reflect changes to its properties from within IWbemService::ExecMethodAsync. For this reason, an instance of OV_Action is specified as the Action parameter, even though this method is already called in the context of this instance.

As with the OV_Action::Create method, the following checking is performed:

If a required property is missing, the method fails with MDLAPI_E_PROPERTY_MISSING.
If a property has an invalid value, the method fails with MDLAPI_E_INVALID_PROPERTY.
If the Caption property is an empty string, contains invalid characters, or has more than 1024 characters, the method fails with MDLAPI_E_INVALID_CAPTION.
If a service with the same hierarchical path already exists, the method fails with MDLAPI_E_TOOL_HIERPATH_EXISTS.

Return Value

None.

Extended Status Codes

MDLAPI_E_PROPERTY_MISSING: Property is not set.
MDLAPI_E_INVALID_PROPERTY: Property is not valid.
MDLAPI_E_INVALID_CAPTION: Specified object Caption parameter is not valid.
MDLAPI_E_TOOL_HIERPATH_EXISTS: Tool with the same Caption is already a child of the parent tool group.
MDLAPI_E_TRANSACTION_NOT_EXIST: Transaction with the specified ID does not exist.

OV_Action::Modify() OV_Action::Modify_Trans()

OV_Action::Modify()
OV_Action::Modify_Trans()