MI_ProviderFT_ModifyInstance function pointer
Modify an existing CIM instance in the target namespace. The instance must already exist.
Syntax
typedef void ( MI_CALL *MI_ProviderFT_ModifyInstance)(
void *self,
MI_Context *context,
_In_ const MI_Char *nameSpace,
_In_ const MI_Char *className,
const MI_Instance *modifiedInstance,
const MI_PropertySet *propertySet
);
Parameters
self
The provider state data.context
The request context.nameSpace [in]
Modify an instance in this namespace.className [in]
Modify an instance of this class.modifiedInstance
Identifies the instance to be modified through its key properties and provides new property values.propertySet
Which properties to modify or NULL to specify the properties to modify in the modifiedInstance parameter.
Return value
This function pointer does not return a value.
Remarks
The set of properties that are modified are determined as follows: If the propertySet parameter is not NULL, the elements of the set define zero or more property names. Only properties specified in this set are modified. Unspecified properties are ignored. If the set is empty, no properties are modified. If propertySet is NULL, the properties of the modifiedInstance that are not NULL and whose values are different from the current values of the instance will be modified.
If the specified MI_PropertySet contains invalid property names, the implementation shall reject the request. If a property cannot be modified because, it is a key, it is non-writable, or for any other reason, the implementation shall reject the request.
If this method is successful, all properties to be modified are updated in the specified instance. If it is unsuccessful, no change is made to the specified instance and an error is returned.
On completion the implementation must post the result by using the MI_Context_PostResult method. The expected result is one of the following values.
MI_RESULT_OK
MI_RESULT_ACCESS_DENIED
MI_RESULT_INVALID_NAMESPACE
MI_RESULT_INVALID_CLASS
MI_RESULT_INVALID_PARAMETER
MI_RESULT_NOT_SUPPORTED
MI_RESULT_NOT_FOUND
MI_RESULT_FAILED
Requirements
Minimum supported client |
Windows 8 |
Minimum supported server |
Windows Server 2012 |
Redistributable |
Windows Management Framework 3.0 on Windows Server 2008 R2 with SP1, Windows 7 with SP1, and Windows Server 2008 with SP2 |
Header |
Mi.h |