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

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

Синтаксис

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

[in] instanceKey

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

resultClass

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

role

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

keysOnly

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

[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

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

Разница между этой функцией и функцией MI_Session_AssociatorInstances заключается в том, что эта функция ищет сам объект связи, а функция MI_Session_AssociatorInstances ищет экземпляры, связанные с объектом ключа.

Требования

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

MI_Application_NewSession

MI_OperationCallbacks

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance

MI_Session_AssociatorInstances