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

Создает экземпляр на сервере, который представляет сеанс.

Синтаксис

MI_INLINE void MI_Session_CreateInstance(
  [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).

[in, optional] options

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

namespaceName

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

[in] inboundInstance

MI_Instance , представляющий имя класса и ключи экземпляра, создаваемого на сервере, а также остальные свойства экземпляра, которому будет присвоено значение целевого экземпляра. Иногда ключи доступны только для чтения, поэтому не все ключи нужно указывать. Если указанный экземпляр уже существует, функция завершится ошибкой; чтобы обновить существующий экземпляр, используйте функцию MI_Session_ModifyInstance .

[in, optional] callbacks

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

[out] operation

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

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

None

Требования

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

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance

MI_Session_ModifyInstance