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

Подписывается на указание на сервере, представленном сеансом.

Синтаксис

MI_INLINE void MI_Session_Subscribe(
  [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] const MI_SubscriptionDeliveryOptions *deliverOptions,
  [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] deliverOptions

Необязательная MI_SubscriptionDeliveryOptions структура, определяющая параметры доставки подписки. Для транспорта WMI DCOM это значение может иметь значение Null. Для WinRM этот параметр задает такие параметры, как режим доставки и учетные данные принудительной доставки.

[in, optional] callbacks

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

[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_GetIndication

Удаленное управление Windows