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

Возвращает синхронный результат для операции класса.

Синтаксис

MI_INLINE MI_Result MI_Operation_GetClass(
  [in]            MI_Operation      *operation,
                  const MI_Class    **classResult,
  [out, optional] MI_Boolean        *moreResults,
  [out, optional] MI_Result         *result,
                  const MI_Char     **errorMessage,
                  const MI_Instance **completionDetails
);

Параметры

[in] operation

Дескриптор операции, возвращаемый операцией сеанса экземпляра.

classResult

Возвращенный класс. Если операция завершается сбоем, это значение может иметь значение Null. Возвращенный класс действителен до следующего вызова MI_Operation_GetClass или MI_Operation_Close. Если класс должен оставаться активным в этих вызовах, класс необходимо клонировать с помощью MI_Class_Clone.

[out, optional] moreResults

Возвращено логическое значение, указывающее, доступны ли дополнительные результаты. Значение MI_TRUE означает, что можно получить дополнительные результаты. Это достигается путем вызова этой функции до тех пор, пока moreResults не имеет значение MI_FALSE (даже если операция отменена через MI_Operation_Cancel. Вызов MI_Operation_Close перед получением последнего результата, где параметр moreResults имеет значение MI_FALSE , приведет к тому, что функция MI_Operation_Close перестанет отвечать.

[out, optional] result

Возвращаемое значение, указывающее на успешное или неудачное выполнение вызова функции. Значение MI_RESULT_OK указывает на успешное выполнение. В противном случае для определения причины сбоя следует использовать возвращаемое значение errorMessage .

errorMessage

В случае ошибки это возвращаемое значение предоставляет дополнительные отладочные сведения о причине сбоя. Это сообщение об ошибке имеет то же время существования, что и значение classResult .

completionDetails

В случае ошибки это возвращаемое значение предоставляет дополнительные сведения об ошибке , обычно в виде объекта CIM_Error (или производного класса). Этот возвращаемый экземпляр имеет то же время существования, что и значение classResult . Если это значение должно оставаться активным дольше, его необходимо клонировать с помощью MI_Instance_Clone.

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

Значение перечисления MI_Result , указывающее код возврата функции. Это может быть один из следующих кодов.

Комментарии

Эта функция будет блокироваться, пока не будет доступен результат. Его необходимо вызывать до тех пор, пока не будет возвращен параметр moreResults со значением MI_FALSE. Если обратный вызов класса зарегистрирован, вызов этой функции является ошибкой.

Требования