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


Метод SWbemObject.AssociatorsAsync_

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

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

Синтаксис

SWbemObject.AssociatorsAsync_( _
  ByVal objWbemSink, _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Параметры

objWbemSink [in]

Обязательный. Приемник объектов, который асинхронно получает объекты в качестве обратного вызова.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

wbemFlagSendStatus (128 (0x80))

Вызывает асинхронные вызовы для отправки обновлений состояния в обработчик событий SWbemSink.OnProgress для приемника объектов.

wbemFlagDontSendStatus (0 (0x0))

Запрещает асинхронным вызовам отправлять обновления состояния в обработчик событий OnProgress для приемника объектов.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

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

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

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

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

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

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

Этот метод не возвращает значение. В случае успешного выполнения приемник получает событие OnObjectReady для каждого экземпляра. После последнего экземпляра приемник объекта получает событие OnCompleted .

Коды ошибок

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

wbemErrAccessDenied — 2147749891 (0x80041003)

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

wbemErrFailed — 2147449889 (0x7FFF7C21)

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

wbemErrInvalidParameter — 2147749896 (0x80041008)

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

wbemErrOutOfMemory — 2147749894 (0x80041006)

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

Комментарии

Этот вызов возвращается немедленно. Запрошенные объекты и состояние возвращаются вызывающей стороне через обратные вызовы, доставляемые в приемник, указанный в objWbemSink. Чтобы обработать каждый объект при поступлении, создайте objWbemSink. Подпрограмма события OnObjectReady . После возврата всех объектов можно выполнить окончательную обработку в реализации objWbemSink. Событие OnCompleted .

Асинхронный обратный вызов позволяет пользователю, не прошедшему проверку подлинности, предоставлять данные в приемник. Это создает угрозы безопасности для сценариев и приложений. Чтобы устранить риски, используйте полусинхронную связь или синхронную связь. Дополнительные сведения см. в разделе Вызов метода.

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

Требования

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

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

SWbemObject

SWbemServices.AssociatorsOfAsync

SWbemObject.References_

SWbemServices.ReferencesTo