Метод 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 |
| Заголовок |
|
| Библиотека типов |
|
| DLL |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |