Поделиться через


Метод SWbemServices.ReferencesTo

Метод ReferencesTo объекта SWbemServices возвращает коллекцию всех классов или экземпляров ассоциаций, ссылающихся на определенный исходный класс или экземпляр. Этот метод выполняет ту же функцию, что и запрос REFERENCES OF WQL.

Этот метод вызывается в полусинхронном режиме. Дополнительные сведения см. в разделе Вызов метода .

Описание этого синтаксиса см. в разделе Соглашения о документах для API сценариев.

Синтаксис

objWbemObjectSet = .ReferencesTo( _
  ByVal strObjectPath, _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

Параметры

strObjectPath

Обязательный. Строка, содержащая путь к объекту источника для этого метода. Дополнительные сведения см. в разделе Описание расположения объекта WMI.

strResultClass [необязательно]

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

strRole [необязательно]

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

bClassesOnly [необязательно]

Логическое значение, указывающее, следует ли возвращать список имен классов, а не фактические экземпляры классов. Это классы, к которым принадлежат объекты ассоциации. Значение по умолчанию для этого параметра — FALSE.

bSchemaOnly [необязательно]

Логическое значение, указывающее, применяется ли запрос к схеме, а не к данным. Значение по умолчанию для этого параметра — FALSE. Ему может быть присвоено значение TRUE , только если параметр strObjectPath указывает путь к объекту класса . Если задано значение TRUE, набор возвращаемых конечных точек представляет классы, которые правильно связаны с исходным классом в схеме.

strRequiredQualifier [необязательно]

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

iFlags [необязательно]

Целое число, указывающее дополнительные флаги для операции. По умолчанию для этого параметра используется wbemFlagReturnImmediately, который направляет вызов на немедленное возвращение, а не ожидание завершения запроса. Этот параметр может принимать следующие значения.

wbemFlagForwardOnly (32 (0x20))

Возвращает перечислитель только для прямого доступа. Перечислители только вперед обычно выполняются гораздо быстрее и используют меньше памяти, чем обычные перечислители, но не разрешают вызовы SWbemObject.Clone_.

wbemFlagBidirectional (0 (0x0))

Приводит к тому, что инструментарий управления Windows (WMI) сохраняет указатели на объекты перечисления до тех пор, пока клиент не отпустит перечислитель.

wbemFlagReturnImmediately (16 (0x10))

Вызывает немедленный возврат вызова.

wbemFlagReturnWhenComplete (0 (0x0))

Вызывает блокировку этого вызова до завершения запроса. Этот флаг вызывает метод в синхронном режиме.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Заставляет WMI возвращать данные о поправках класса вместе с определением базового класса. Дополнительные сведения см. в разделе Локализация сведений о классе WMI.

objWbemNamedValueSet [необязательно]

Как правило, это не определено. В противном случае это объект SWbemNamedValueSet , элементы которого представляют сведения контекста, которые могут использоваться поставщиком, обслуживающим запрос. Поставщик, поддерживающий или требующий таких сведений, должен документировать имена распознаваемых значений, тип данных значения, допустимые значения и семантику.

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

Если метод выполнен успешно, метод возвращает объект SWbemObjectSet .

Коды ошибок

После завершения метода ReferencesTo объект Err может содержать один из кодов ошибок в следующем списке.

Примечание

Возвращаемая коллекция с нулевыми элементами не является ошибкой.

wbemErrAccessDenied — 2147749891 (0x80041003)

Текущий пользователь не имеет разрешения на просмотр одного или нескольких классов, возвращаемых вызовом.

wbemErrFailed — 2147749889 (0x80041001)

Незаданная ошибка.

wbemErrInvalidParameter — 2147749896 (0x80041008)

Указан недопустимый параметр.

wbemErrOutOfMemory — 2147749894 (0x80041006)

Недостаточно памяти для завершения операции.

wbemFlagUseAmendedQualifiers — 131072 (0x20000)

Заставляет WMI возвращать данные о поправках класса с определением базового класса.

Комментарии

Дополнительные сведения о связанных запросах WQL REFERENCES OF, исходных экземплярах и объектах связи см. в разделе ASSOCIATORS OF Statement.

Требования

Требование Значение
Минимальная версия клиента
Windows Vista
Минимальная версия сервера
Windows Server 2008
Заголовок
Wbemdisp.h
Библиотека типов
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemServices
IID
IID_ISWbemServices

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

SWbemServices

SWbemObject.Associators_

SWbemObject.References_

SWbemServices.AssociatorsOf