Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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

See also

MI_ProviderFT
MI_Context
MI_Instance
MI_PropertySet

 

 

Show: