Método SWbemObject.ReferencesAsync_

O método ReferencesAsync\_ do SWbemObject fornece uma coleção de todas as classes de associação ou instâncias que se referem ao objeto atual. Esse método executa a mesma função que a consulta WQL REFERENCES OF executa.

Para ver uma explicação dessa sintaxe, confira Convenções de documento para a API de script.

Sintaxe

SWbemObject.ReferencesAsync_( _
  ByVal objWbemSink, _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ 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.

strResultClass [entrada, opcional]

Cadeia de caracteres que contém um nome de classe. Se especificado, este parâmetro indica que os objetos de associação retornados devem pertencer à classe especificada neste parâmetro ou serem derivados dela.

strRole [in, opcional]

Cadeia de caracteres que contém um nome de propriedade. Se especificado, esse parâmetro indicará que os objetos de associação retornados devem estar restritos àqueles nos quais o objeto de origem desempenha uma função específica. O nome de uma propriedade de referência especificada define a função de uma associação.

bClassesOnly [entrada, opcional]

Valor booliano que indica se uma lista de nomes de classe deve ou não ser retornada em vez das instâncias reais das classes. Essas são as classes às quais os objetos de associação pertencem. O valor padrão para esse parâmetro é FALSE.

bSchemaOnly [in, opcional]

Valor booliano que indica se a consulta se aplica ou não 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 representa classes que estão adequadamente associadas à classe de origem no esquema.

strRequiredQualifier [in, opcional]

Cadeia de caracteres que contém um nome de qualificador. Se especificado, esse parâmetro indicará que os objetos de associação retornados devem incluir o qualificador especificado.

iFlags [in, 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 a WMI (Instrumentação de Gerenciamento do Windows) retorne dados de aditamento de classe com a definição da classe base. 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, optional]

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 objetos e a origem da chamada pode ser extraída usando o método SWbemNamedValueSet.Item. Para obter mais informações, consulte 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 ReferencesAsync_, o objeto Err pode 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 – 2147749889 (0x80041001)

Erro não especificado.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Foi especificado um parâmetro invá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 a consulta WQL REFERENCES OF associada, instâncias de origem e objetos de associação, consulte Instrução ASSOCIATORS OF.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Confira também

SWbemObject

SWbemObject.Associators_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo

SWbemServices.ReferencesToAsync