Метод SWbemObject.Associators_

Метод Associators_ объекта SWbemObject возвращает коллекцию объектов (классов или экземпляров), связанных с текущим объектом. Эти возвращаемые объекты называются конечными точками. Этот метод выполняет ту же функцию, что и запрос ASSOCIATORS OF WQL.

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

Синтаксис

objWbemObjectSet = .Associators_( _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

wbemFlagForwardOnly (32 (0x20))

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

wbemFlagBidirectional (0 (0x0))

Заставляет WMI сохранять указатели на объекты перечисления до тех пор, пока клиент не выпустит перечислитель.

wbemFlagReturnImmediately (16 (0x10))

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

wbemFlagReturnWhenComplete (0 (0x0))

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

wbemFlagUseAmendedQualifiers (131072 (0x20000))

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

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

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

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

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

Коды ошибок

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

wbemErrAccessDenied — 2147749891 (0x80041003)

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

wbemErrFailed — 2147749889 (0x80041001)

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

wbemErrInvalidParameter — 2147749896 (0x80041008)

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

wbemErrOutOfMemory — 2147749894

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

Комментарии

Дополнительные сведения о связанном WQL-запросе ASSOCIATORS OF, исходных экземплярах и конечных точках см. в разделе ОПЕРАТОР ASSOCIATORS OF.

Требования

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

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

SWbemObject

SWbemObject.References_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo