Evento ISWbemSinkEvents::OnObjectReady
L'evento OnObjectReady di un oggetto SWbemSink viene attivato quando un'operazione asincrona restituisce un oggetto. Usare questo evento per elaborare oggetti da chiamate asincrone, ad esempio SWbemObject.InstancesAsync_ o SWbemServices.ExecQueryAsync. OnObjectReady restituisce uno SWbemObject ogni volta che non viene completata l'enumerazione.
Per una spiegazione di questa sintassi, vedere Convenzioni di documento per l'API scripting.
Sintassi
SWbemSink.OnObjectReady( _
ByVal objWbemObject, _
ByVal objWbemAsyncContext _
)
Parametri
-
objWbemObject
-
Oggetto SWbemObject . È simile a quello restituito dall'equivalente sincrono della chiamata asincrona che attiva questo evento. Ad esempio, una chiamata al metodo SWbemServices.GetAsync restituisce un oggetto SWbemObject nel parametro objWbemObject dell'evento OnObjectReady dell'oggetto SWbemSink , passato come parametro objWbemObject della chiamata originale. Lo stesso oggetto SWbemObject può essere ottenuto usando una chiamata sincrona equivalente a SWbemServices.Get.
-
objWbemAsyncContext
-
Oggetto SWbemNamedValueSet passato alla chiamata asincrona originale. Usare questo parametro per identificare l'origine della chiamata asincrona che attiva questo evento quando vengono eseguite più chiamate asincrone usando questo sink di oggetti.
Valore restituito
Questo evento non restituisce un valore.
Codici di errore
Al termine dell'evento OnObjectReady , l'oggetto Err può contenere uno dei codici di errore seguenti.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Errore non specificato.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
Memoria insufficiente per completare l'operazione.
-
wbemErrTransportFailure - 2147749909 (0x80041015)
-
Si è verificato un errore di rete, impedendo la normale operazione.
Commenti
Un callback asincrono consente a un utente non autenticato di fornire dati al sink. Ciò comporta rischi di sicurezza per gli script e le applicazioni. Per eliminare i rischi, usare la comunicazione semi sincrona o la comunicazione sincrona. Per altre informazioni, vedere Chiamata di un metodo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Intestazione |
|
| IDL |
|
| DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSinkEvents |