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

Находит экземпляры, связанные с конкретным экземпляром ключа.

Синтаксис

MI_INLINE void MI_Session_AssociatorInstances(
  [in]           MI_Session            *session,
                 MI_Uint32             flags,
  [in, optional] MI_OperationOptions   *options,
                 const MI_Char         *namespaceName,
  [in]           const MI_Instance     *instanceKey,
                 const MI_Char         *assocClass,
                 const MI_Char         *resultClass,
                 const MI_Char         *role,
                 const MI_Char         *resultRole,
                 MI_Boolean            keysOnly,
  [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, содержащая необязательное имя пространства имен для выполнения операции. Если значение не указано, сервер выберет значение по умолчанию. Пространство имен не может содержать имя компьютера. Он может быть только в виде имен пространств имен, разделенных символом косой черты, например root/cimv2.

[in] instanceKey

MI_Instance, представляющий имя класса и ключи экземпляра, с которого будет начинаться связь.

assocClass

Строка, заканчивающаяся значением NULL, представляющая необязательное значение, указывающее, чтобы сопоставить связь только с помощью этого класса ассоциации. Если это значение равно NULL, будут использоваться все классы ассоциаций.

resultClass

Строка, завершающаяся значением NULL, представляющая необязательные значения, ограничивающие результирующий набор только этим классом. Укажите ЗНАЧЕНИЕ NULL, если фильтрация не требуется.

role

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

resultRole

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

keysOnly

Если задано значение MI_TRUE операция извлекает только ключевые свойства экземпляров. В противном случае укажите MI_FALSE.

[in, optional] callbacks

Необязательный MI_OperationCallbacks структура, определяющая операционные обратные вызовы для получения результата экземпляра и семантики CIM. Для асинхронной операции необходимо указать обратный вызов. Для синхронной операции укажите ЗНАЧЕНИЕ NULL; затем клиент должен вызвать MI_Operation_GetInstance , чтобы получить результаты.

[out] operation

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

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

None

Remarks

Связь — это связь между двумя объектами. Он представлен третьим объектом, содержащим два свойства, каждое из которых является ссылкой на один из этих двух связанных объектов. Параметр role — это свойство ссылки объекта ассоциации, указывающее на связанный объект. Параметр resultRole указывает на другой результирующий объект.

Требования

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

MI_Application_NewSession

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance