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


Метод SWbemObject.References_

Метод References_ объекта SWbemObject возвращает коллекцию всех классов или экземпляров ассоциаций, ссылающихся на текущий объект.

Этот метод выполняет ту же функцию, что и запрос REFERENCES OF WQL.

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

Синтаксис

objWbemObjectSet = .References_( _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Параметры

strResultClass [in, необязательный]

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

strRole [in, необязательный]

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

bClassesOnly [in, необязательный]

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

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

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

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

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

iFlags [in, необязательный]

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

wbemFlagForwardOnly (32 (0x20))

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

wbemFlagBidirectional (0 (0x0))

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

wbemFlagReturnImmediately (16 (0x10))

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

wbemFlagReturnWhenComplete (0 (0x0))

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

wbemFlagUseAmendedQualifiers (131072 (0x20000))

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

objwbemNamedValueSet [in, необязательный]

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

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

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

Коды ошибок

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

wbemErrAccessDenied — 2147749891 (0x80041003)

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

wbemErrFailed — 2147749889 (0x80041001)

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

wbemErrInvalidParameter — 2147749896 (0x80041008)

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

wbemErrOutOfMemory — 2147749894 (0x80041006)

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

Комментарии

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

Требования

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

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

SWbemObject

SWbemObject.Associators_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo