Updates an existing instance in the server represented by the session.
void MI_Session_ModifyInstance( _In_ MI_Session *session, MI_Uint32 flags, _In_opt_ MI_OperationOptions *options, _In_opt_z_ const MI_Char *namespaceName, _In_ const MI_Instance *inboundInstance, _In_opt_ MI_OperationCallbacks *callbacks, _Out_ MI_Operation *operation );
- session [in]
Session handle returned from MI_Application_NewSession.
Must be 0.
- options [in, optional]
Optional MI_OperationOptions value that specifies options such as timeouts and how to control the CIM semantics. Specify Null if no operation options are to be sent.
An optional, null-terminated string that represents the namespace name to carry out the operation. If none is specified, the server will pick a default. The namespace cannot include a computer name. It can only be in the form of a namespace name separated by a slash mark character (/). For example, the following would be a valid namespaceName value: root/cimv2.
- inboundInstance [in]
An MI_Instance that represents the class name and key of the instance to be modified on the server.
- callbacks [in, optional]
Optional MI_OperationCallbacks structure that defines the operational callbacks to receive the instance result and CIM semantics. To carry out the operation asynchronously, the structure's instanceResult callback member must be specified. If this member is not specified, the client must call the MI_Operation_GetInstance function to retrieve the results.
- operation [out]
Returned operation handle that must be closed via MI_Operation_Close once complete. Calling MI_Operation_Cancel before it is complete will cause the operation to shutdown. MI_Operation_Close and MI_Operation_Cancel can be called from any operation.
This function does not return a value.
The function will fail if the instance does not exist.
Minimum supported client
Minimum supported server
|Windows Server 2012|
|Windows Management Framework 3.0 on Windows Server 2008 R2 with SP1, Windows 7 with SP1, and Windows Server 2008 with SP2|
Build date: 11/18/2013