Método SWbemObject.AssociatorsAsync_
O método AssociatorsAsync_ do SWbemObject obtém objetos (classes ou instâncias) associados ao objeto atual. Esses objetos são chamados de pontos de extremidade. Esse método executa a mesma função que a consulta WQL ASSOCIATORS OF.
Para obter uma explicação dessa sintaxe, confira Convenções de documentação para a API de Script.
Sintaxe
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 ] _
)
Parâmetros
-
objWbemSink [entrada]
-
Obrigatórios. Coletor de objetos que recebe os objetos de maneira assíncrona como um retorno de chamada.
-
strAssocClass [entrada, opcional]
-
Cadeia de caracteres que contém uma classe de associação. Se especificado, esse parâmetro indicará que os pontos de extremidade retornados devem ser associados à origem por meio da classe de associação especificada ou de uma classe derivada dessa classe de associação.
-
strResultClass [entrada, opcional]
-
Cadeia de caracteres que contém um nome de classe. Se especificado, este parâmetro indicará que os pontos de extremidade retornados devem pertencer à classe especificada neste parâmetro ou serem derivados dela.
-
strResultRole [entrada, opcional]
-
Cadeia de caracteres que contém um nome de propriedade. Se especificado, esse parâmetro indicará que os pontos de extremidade retornados devem desempenhar uma função específica na associação com o objeto de origem. A função é definida pelo nome de uma propriedade especificada (que deve ser uma propriedade de referência) de uma associação.
-
strRole [entrada, opcional]
-
Cadeia de caracteres que contém um nome de propriedade. Se especificado, esse parâmetro indicará que os pontos de extremidade retornados devem participar de uma associação com o objeto de origem no qual o objeto de origem desempenha uma função específica. A função é definida pelo nome de uma propriedade especificada (que deve ser uma propriedade de referência) de uma associação.
-
bClassesOnly [entrada, opcional]
-
Valor booliano que indica se uma lista de nomes de classe deve ser retornada no lugar das instâncias reais das classes. Essas são as classes às quais as instâncias de ponto de extremidade pertencem. O valor padrão para esse parâmetro é FALSE.
-
bSchemaOnly [entrada, opcional]
-
Valor booliano que indica se a consulta se aplica ao esquema em vez dos dados. O valor padrão para esse parâmetro é FALSE. Ele só poderá ser definido como TRUE se o objeto no qual esse método é invocado for uma classe. Quando definido como TRUE, o conjunto de pontos de extremidade retornados representará classes que estão adequadamente associadas à classe de origem no esquema.
-
strRequiredAssocQualifier [entrada, opcional]
-
Cadeia de caracteres que contém um nome de qualificador. Se especificado, esse parâmetro indicará que os pontos de extremidade retornados devem ser associados ao objeto de origem por meio de uma classe de associação que inclui o qualificador especificado.
-
strRequiredQualifier [entrada, opcional]
-
Cadeia de caracteres que contém um nome de qualificador. Se especificado, esse parâmetro indicará que os pontos de extremidade retornados devem incluir o qualificador especificado.
-
iFlags [entrada, opcional]
-
Valor inteiro que especifica sinalizadores adicionais para a operação. Esse parâmetro pode aceitar os valores a seguir.
-
wbemFlagSendStatus (128 (0x80))
-
Faz com que chamadas assíncronas enviem atualizações de status ao manipulador de eventos SWbemSink.OnProgress do coletor de objetos.
-
wbemFlagDontSendStatus (0 (0x0))
-
Evita que chamadas assíncronas enviem atualizações de status ao manipulador de eventos OnProgress do coletor de objetos.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Faz com que o WMI retorne as descrições de classe e propriedade localizadas. Para obter mais informações, consulte Localizar informações de classe WMI.
objwbemNamedValueSet [entrada, opcional]
Normalmente, isso é indefinido. Caso contrário, esse será um objeto SWbemNamedValueSet cujos elementos representam as informações de contexto que podem ser usadas pelo provedor que está atendendo à solicitação. Um provedor que dê suporte ou exija essas informações deve documentar os nomes de valor reconhecidos, o tipo de dados do valor, os valores permitidos e a semântica.
objWbemAsyncContext [entrada, opcional]
Este é um objeto SWbemNamedValueSet que é retornado ao coletor de objetos para identificar a origem da chamada assíncrona original. Use esse parâmetro se estiver fazendo várias chamadas assíncronas usando o mesmo coletor de objetos. Para usar esse parâmetro, crie um objeto SWbemNamedValueSet e use o método SWbemNamedValueSet.Add para adicionar um valor que identifique a chamada assíncrona que você está fazendo. Esse objeto SWbemNamedValueSet é retornado ao coletor de objeto, e a origem da chamada pode ser extraída usando o método SWbemNamedValueSet.Item. Para obter mais informações, confira Como chamar um método.
Retornar valor
Esse método não retorna um valor. Se tiver êxito, o coletor receberá um evento OnObjectReady por instância. Após a última instância, o coletor de objetos receberá um evento OnCompleted.
Códigos do Erro
Após a conclusão do método AssociatorsAsync_, o objeto Err poderá conter um dos códigos de erro da lista a seguir.
-
wbemErrAccessDenied – 2147749891 (0x80041003)
-
O usuário atual não tem permissão para exibir uma ou mais das classes retornadas pela função.
-
wbemErrFailed – 2147449889 (0x7FFF7C21)
-
Erro não especificado.
-
wbemErrInvalidParameter – 2147749896 (0x80041008)
-
Um parâmetro especificado não é válido.
-
wbemErrOutOfMemory – 2147749894 (0x80041006)
-
Não há memória suficiente para concluir a operação.
Comentários
Essa chamada é retornada imediatamente. Os objetos solicitados e o status são retornados ao chamador por meio de retornos de chamada entregues ao coletor especificado no objWbemSink. Para processar cada objeto que chegar, crie uma sub-rotina do evento objWbemSink.OnObjectReady. Depois que todos os objetos forem retornados, você poderá executar o processamento final na implementação do evento objWbemSink.OnCompleted.
Um retorno de chamada assíncrono permite que um usuário não autenticado forneça dados ao coletor. Isso representa riscos de segurança para seus scripts e aplicativos. Para eliminar os riscos, use comunicação semissíncrona ou síncrona. Para obter mais informações, consulte Chamar um método.
Para obter mais informações sobre as consultas WQL associadas ASSOCIATORS OF, as instâncias de origem e os pontos de extremidade, confira Instrução ASSOCIATORS OF.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Cabeçalho |
|
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |