Метод SWbemServices.ReferencesTo

Статья
06/13/2023

Метод 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 возвращать данные о поправках класса с определением базового класса.

Требования

Требование	Значение
Минимальная версия клиента	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