Evento ISWbemSinkEvents::OnObjectReady
O evento OnObjectReady de um objeto SWbemSink é disparado quando uma operação assíncrona retorna um objeto. Use esse evento para processar objetos de chamadas assíncronas, como SWbemObject.InstancesAsync_ ou SWbemServices.ExecQueryAsync. OnObjectReady retorna um SWbemObject cada vez até que a enumeração seja concluída.
Para obter uma explicação dessa sintaxe, consulte Convenções de Documento para a API de Script.
Sintaxe
SWbemSink.OnObjectReady( _
ByVal objWbemObject, _
ByVal objWbemAsyncContext _
)
Parâmetros
-
objWbemObject
-
Um objeto SWbemObject . Isso é semelhante ao que é retornado pelo equivalente síncrono da chamada assíncrona que dispara esse evento. Por exemplo, uma chamada para o método SWbemServices.GetAsync retorna um SWbemObject no parâmetro objWbemObject do evento OnObjectReady do objeto SWbemSink , que é passado como o parâmetro objWbemObject da chamada original. O mesmo objeto SWbemObject pode ser obtido usando uma chamada síncrona equivalente para SWbemServices.Get.
-
objWbemAsyncContext
-
Um objeto SWbemNamedValueSet que é passado para a chamada assíncrona original. Use esse parâmetro para identificar a origem da chamada assíncrona que dispara esse evento quando várias chamadas assíncronas são feitas usando esse coletor de objeto.
Valor retornado
Esse evento não retorna um valor.
Códigos do Erro
Após a conclusão do evento OnObjectReady , o objeto Err pode conter um dos códigos de erro abaixo.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Erro não especificado.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
Memória insuficiente para concluir a operação.
-
wbemErrTransportFailure - 2147749909 (0x80041015)
-
Erro de rede, impedindo a operação normal.
Comentários
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 comunicação síncrona. Para obter mais informações, consulte Chamando um método.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Cabeçalho |
|
| IDL |
|
| DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSinkEvents |