Método SWbemServices.GetAsync
O método GetAsync do objeto SWbemServices recupera um objeto, que é uma definição de classe ou uma instância, com base no caminho do objeto.
Esse método recupera apenas objetos do namespace associado ao objeto SWbemServices atual.
Esse método é chamado no modo assíncrono. Para obter mais informações, consulte Chamar um método.
Para conferir uma explicação dessa sintaxe, confira Convenções de documentação para API de script.
Sintaxe
SWbemServices.GetAsync( _
ByVal objWbemSink, _
[ ByVal strObjectPath ], _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
Parâmetros
-
objWbemSink
-
Obrigatórios. Coletor de objeto que obtém objetos de forma assíncrona. Crie um objeto SWbemSink para receber os objetos.
-
strObjectPath [opcional]
-
Caminho do objeto que deseja recuperar. Se esse valor estiver vazio, o objeto vazio retornado poderá se tornar uma nova classe. Para obter mais informações, confira Descrever o local de um objeto do WMI.
-
iFlags [opcional]
-
Inteiro que determina o comportamento da chamada. 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 retorne dados de aditamento da classe com a definição da classe base. Para obter mais informações, consulte Localizar informações de classe WMI.
objwbemNamedValueSet [opcional]
Normalmente, esse valor é 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 [opcional]
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 quando o objeto estiver disponível.
Códigos do Erro
Após a conclusão do método GetAsync, o objeto de Erro 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 acessar o objeto.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Erro não especificado.
-
wbemErrInvalidParameter – 2147749896 (0x80041008)
-
Um parâmetro especificado não é válido.
-
wbemErrInvalidObjectPath - 2147749946 (0x8004103A)
-
O caminho especificado não era válido.
-
wbemErrNotFound – 2147749890 (0x80041002)
-
Não foi possível encontrar um objeto solicitado.
-
wbemErrOutOfMemory – 2147749894 (0x80041006)
-
Não há memória suficiente para concluir a operação.
Comentários
Essa chamada é retornada imediatamente. O objeto solicitado e o status são retornados ao chamador por meio de um retorno de chamada entregue ao coletor especificado no objWbemSink. Para processar o objeto quando ele retornar, crie um objWbemSink.OnObjectReady ou um objWbemSink.Sub-rotina de evento 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 a comunicação semissíncrona ou síncrona. Para obter mais informações, confira 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 |