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

Запросы набора экземпляров на основе выражения запроса.

Синтаксис

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

Параметры

[in] session

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

flags

Сведения о типе среды выполнения (RTTI) и полиморфные флаги.

[in, optional] options

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

namespaceName

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

queryDialect

Необязательная строка со значением NULL, представляющая диалект передаваемого запроса. Это может быть WQL или CQL. Обратите внимание, что некоторые серверы поддерживают не все типы запросов.

queryExpression

Необязательная строка со значением NULL, представляющая выполняемое выражение запроса. Обычно требуется запрос, но если используется конечная точка WS-Management, можно передать URI ресурса. Для транспорта WMI DCOM необходимо указать это значение.

[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

Требования

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

MI_Application_NewSession

MI_OperationCallbacks

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance