Metodo SWbemServices.DeleteAsync
Il metodo DeleteAsync dell'oggetto SWbemServices elimina la classe o l'istanza specificata nel percorso dell'oggetto. La chiamata a DeleteAsync restituisce immediatamente e i risultati e lo stato vengono restituiti al chiamante tramite eventi recapitati al sink specificato in objWbemSink. Per altre informazioni sulla creazione di un sink, vedere Ricezione di un evento WMI. È possibile eliminare solo gli oggetti nello spazio dei nomi a cui si è connessi.
Se un provider dinamico fornisce la classe o l'istanza, a volte non è possibile eliminare questo oggetto a meno che il provider supporti l'eliminazione della classe o dell'istanza.
Il metodo viene chiamato nella modalità asincrona. Per altre informazioni, vedere Chiamata di un metodo.
Per una spiegazione di questa sintassi, vedere Convenzioni di documento per l'API scripting.
Sintassi
SWbemServices.DeleteAsync( _
[ ByVal ObjWbemSink ], _
ByVal strObjectPath, _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
Parametri
-
ObjWbemSink [facoltativo]
-
Sink oggetto che riceve i risultati dell'eliminazione. Creare un oggetto SWbemSink per ricevere gli oggetti.
-
strObjectPath
-
Obbligatorio. Stringa contenente il percorso dell'oggetto all'oggetto da eliminare. Per altre informazioni, vedere Descrizione della posizione di un oggetto WMI.
-
iFlags [facoltativo]
-
Determina se vengono restituiti gli aggiornamenti dello stato. Questo parametro può accettare i valori seguenti.
-
wbemFlagSendStatus (128 (0x80))
-
Causa chiamate asincrone per inviare gli aggiornamenti dello stato al gestore eventi OnProgress per il sink di oggetti.
-
wbemFlagDontSendStatus (0 (0x0))
-
Impedisce alle chiamate asincrone di inviare aggiornamenti dello stato al gestore eventi OnProgress per il sink di oggetti.
objWbemNamedValueSet [facoltativo]
In genere, questo è indefinito. In caso contrario, si tratta di un oggetto SWbemNamedValueSet i cui elementi rappresentano le informazioni di contesto che possono essere usate dal provider che esegue la manutenzione della richiesta. Un provider che supporta o richiede tali informazioni deve documentare i nomi di valore riconosciuti, il tipo di dati del valore, i valori consentiti e la semantica.
objWbemAsyncContext [facoltativo]
Oggetto SWbemNamedValueSet che restituisce al sink dell'oggetto per identificare l'origine della chiamata asincrona originale. Usare questo parametro se si effettuano più chiamate asincrone usando lo stesso sink di oggetti. Per usare questo parametro, creare un oggetto SWbemNamedValueSet e usare il metodo SWbemNamedValueSet.Add per aggiungere un valore che identifica la chiamata asincrona eseguita. Questo oggetto SWbemNamedValueSet viene restituito al sink dell'oggetto e l'origine della chiamata può essere estratta usando il metodo SWbemNamedValueSet.Item . Per altre informazioni, vedere Chiamata di un metodo.
Valore restituito
Questo metodo non restituisce valori. Se la chiamata ha esito positivo, il sink dell'oggetto riceve la notifica dell'eliminazione.
Codici di errore
Al termine del metodo DeleteAsync , l'oggetto Err può contenere uno dei codici di errore nell'elenco seguente.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Errore non specificato.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
È stato specificato un parametro non valido.
-
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.
-
wbemErrNotFound - 2147749890 (0x80041002)
-
Elemento richiesto non trovato.
Commenti
Questa chiamata restituisce immediatamente. Lo stato dell'operazione di eliminazione viene restituito al chiamante tramite un callback recapitato al sink specificato in objWbemSink. È possibile eseguire l'elaborazione finale nell'implementazione dell'objWbemSink. Evento OnCompleted .
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, vedere Impostazione della sicurezza in una chiamata asincrona.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Intestazione |
|
| Libreria dei tipi |
|
| DLL |
|
| CLSID |
CLSID_SWbemServices |
| IID |
IID_ISWbemServices |