Metodo ISWbemSink::Cancel
Il metodo Cancel dell'oggetto SWbemSink annulla tutte le operazioni asincrone in sospeso associate a questo sink di oggetti.
Per una spiegazione di questa sintassi, vedere Convenzioni di documento per l'API scripting.
Sintassi
SWbemSink.Cancel()
Parametri
Questo metodo non presenta parametri.
Valore restituito
Questo metodo non restituisce valori.
Codici di errore
Al termine del metodo Cancel , 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.
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
Il nome utente corrente o specificato e la password non sono validi o autorizzati a effettuare la connessione.
Commenti
Non è possibile annullare una sola chiamata asincrona. Se più chiamate asincrone sono in sospeso che usano questo sink di oggetti, questo metodo annulla tutte le chiamate asincrone usando questo sink di oggetti. Le chiamate asincrone associate ad altri sink di oggetti continuano a non essere interessate.
Non è possibile assegnare questo sink a Nothing per annullare un'operazione asincrona. È necessario chiamare il metodo Cancel per interrompere l'operazione e liberare le risorse associate. Questa operazione è molto importante con operazioni asincrone lunghe, ad esempio query o operazioni che non vengono mai completate, ad esempio ExecNotificationQueryAsync.
Nota
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 semisynchrono o sincrona. Per altre informazioni, vedere Chiamata di un metodo.
Nell'esempio seguente viene illustrato come annullare una chiamata asincrona.
objwbemsink.Cancel()
set objwbemsink= Nothing
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Intestazione |
|
| IDL |
|
| DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSink |