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

Вызывает метод в поставщике.

Синтаксис

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

Параметры

[in] session

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

flags

Флаги сведений о типе среды выполнения (RTTI).

[in, optional] options

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

[in, optional] namespaceName

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

[in, optional] className

Необязательная строка с пустым завершением, представляющая имя класса, частью метода является метод. При передаче входящего экземпляра должно иметь значение NULL.

[in] methodName

Строка, завершающаяся значением NULL, представляющая имя вызываемого метода.

[in, optional] inboundInstance

Экземпляр с ключами, указывающими, какой метод следует вызвать. Если задано значение Null, метод должен быть статическим.

[in, optional] inboundProperties

Свойства входящего метода. Каждое входящее свойство должно быть элементом в экземпляре , а имя элемента должно совпадать с именем параметра метода.

[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

Методы имеют возвращаемые значения, которые будут возвращены в качестве параметра ReturnValue исходящего экземпляра. Могут существовать исходящие свойства, которые будут частью одного и того же результата. Если задан обратный вызов параметра потоковой передачи и все исходящие свойства помечены как потоковые, обратный вызов потоковой передачи будет вызываться для каждого параметра, поддерживающего потоковую передачу. Они будут вызываться до тех пор, пока не будут получены все результаты или пока не будет возвращен окончательный результат.

Требования

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

MI_Application_NewSession

MI_OperationCallbacks

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance