Set Property CIM Operation

Return Request

If unsuccessful, one of the following status codes MUST be returned by this method, where the first applicable error in the list (starting with the first element of the list, and working down) is the error returned. Any additional method-specific interpretation of the error in is given in parentheses.

• CIM_ERR_ACCESS_DENIED
• CIM_ERR_INVALID_NAMESPACE
• CIM_ERR_INVALID_PARAMETER (including missing,duplicate, unrecognized or otherwise incorrect parameters)
• CIM_ERR_INVALID_CLASS (the CIM Class does not exist in the specified namespace)
• CIM_ERR_NOT_FOUND (the CIM Class does exist, but the requested CIM Instance does not exist in the specified namespace)
• CIM_ERR_NO_SUCH_PROPERTY (the CIM Instance does exist, but the requested CIMProperty does not)
• CIM_ERR_FAILED (some other unspecified error occurred)

---

Additional Information

The setProperty operation sets a single property value in a CIM Instance in the target Namespace. 

NameSpace The NameSpace parameter is a string that defines the target namespace. 

InstanceName The InstanceName input parameter specifies the name of the Instance (model path) for which the CIMProperty value is to be updated. 

PropertyName The PropertyName input parameter specifies the name of the CIMProperty whose value is to be updated. 

Newvalue The NewValue input parameter specifies the new value for the CIMProperty (which may be NULL). 

---

Pegasus C++ API as defined in Operations.h

    virtual void setProperty(
        const String& nameSpace,
		const CIMReference& instanceName,
		const String& propertyName,
		const CIMValue& newValue = CIMValue()) = 0;