функция MI_Session_ModifyInstance (mi.h)

Обновления существующий экземпляр на сервере, представленном сеансом.

Синтаксис

MI_INLINE void MI_Session_ModifyInstance(
  [in]           MI_Session            *session,
                 MI_Uint32             flags,
  [in, optional] MI_OperationOptions   *options,
                 const MI_Char         *namespaceName,
  [in]           const MI_Instance     *inboundInstance,
  [in, optional] MI_OperationCallbacks *callbacks,
  [out]          MI_Operation          *operation
);

Параметры

[in] session

Дескриптор сеанса, возвращенный MI_Application_NewSession.

flags

Флаги сведений о типе среды выполнения (RTTI). Может иметь значение 0.

[in, optional] options

Необязательный MI_OperationOptions значение, указывающее такие параметры, как время ожидания и способ управления семантикой CIM. Укажите значение NULL , если нет параметров операции для отправки e.

namespaceName

Необязательная строка со значением NULL, представляющая имя пространства имен для выполнения операции. Если значение не указано, сервер выберет значение по умолчанию. Пространство имен не может содержать имя компьютера. Оно может быть только в виде имени пространства имен, разделенного символом косой черты (/). Например, допустимым значением namespaceName будет следующее: root/cimv2.

[in] inboundInstance

MI_Instance, представляющий имя класса и ключ экземпляра, который необходимо изменить на сервере.

[in, optional] callbacks

Необязательный MI_OperationCallbacks структура, определяющая операционные обратные вызовы для получения результата экземпляра и семантики CIM. Чтобы выполнить операцию асинхронно, необходимо указать член обратного вызова instanceResult структуры. Если этот член не указан, клиент должен вызвать функцию MI_Operation_GetInstance для получения результатов.

[out] operation

Возвращен дескриптор операции, который должен быть закрыт через MI_Operation_Close после завершения. Вызов MI_Operation_Cancel до завершения операции приведет к завершению операции. MI_Operation_Close и MI_Operation_Cancel можно вызывать из любой операции.

Возвращаемое значение

None

Remarks

Если экземпляр не существует, функция завершится ошибкой.

Требования

См. также раздел

MI_Application_NewSession

MI_OperationCallbacks

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance