Método SWbemServices.ReferencesToAsync
O método ReferencesToAsync do objeto SWbemServices retorna todas as classes de associação ou instâncias que se referem a uma classe ou instância de origem específica. Esta função realiza a mesma operação que a consulta REFERENCES OF do WQL executa.
Para obter mais informações sobre o modo assíncrono, consulte Chamar um método.
Para ver uma explicação dessa sintaxe, consulte Convenções de documentação para a API de Script.
Sintaxe
SWbemServices.ReferencesToAsync( _
ByVal ObjWbemSink, _
ByVal strObjectPath, _
[ ByVal strResultClass ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
Parâmetros
-
ObjWbemSink
-
Obrigatórios. Coletor de objetos que recebe os objetos de maneira assíncrona. Crie um objeto SWbemSink para receber os objetos.
-
strObjectPath
-
Obrigatórios. Cadeia de caracteres que contém o caminho do objeto da origem desse método. Para obter mais informações, consulte Localizar informações de classe WMI.
-
strResultClass [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 [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. A função é definida pelo nome de uma propriedade de referência especificada de uma associação.
-
bClassesOnly [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 [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 parâmetro strObjectPath especificar o caminho do objeto de uma classe. Quando definido como TRUE, o conjunto de pontos de extremidade retornados representa classes que estão associadas à classe de origem no esquema.
-
strRequiredQualifier [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 [opcional]
-
Inteiro que especifica sinalizadores adicionais para a operação. O padrão para esse parâmetro é wbemFlagBidirectional. 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 OnProgress para o 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 (Instrumentação de Gerenciamento do Windows) retorne dados de aditamento de classe junto com a definição da classe base. Para obter mais informações, consulte Localizar informações de classe WMI.
objWbemNamedValueSet [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 informações de contexto deve documentar os nomes de valor reconhecidos, o tipo de dados do valor, os valores permitidos e a semântica.
objWbemAsyncContext [opcional]
Este é um objeto SWbemNamedValueSet que é retornado ao coletor de objetos para identificar a origem da chamada assíncrona original. Utilize esse parâmetro para fazer 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 ReferencesToAsync, o objeto de Erro pode conter um dos códigos de erro da lista a seguir.
Observação
Uma coleção retornada sem elementos não é um erro.
-
wbemErrAccessDenied – 2147749891 (0x80041003)
-
O usuário atual não tem a 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 quando ele retornar, crie uma sub-rotina de 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, consulte Configurar a segurança em uma chamada assíncrona.
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_SWbemServices |
IID |
IID_ISWbemServices |