SWbemObject.DeleteAsync_ metodo

Articolo
06/13/2023

Il metodo DeleteAsync_ di SWbemObject elimina in modo asincrono la classe corrente o l'istanza corrente. 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.

Per una spiegazione di questa sintassi, vedere Convenzioni di documento per l'API scripting.

Sintassi

SWbemObject.DeleteAsync_( _
  ByVal objWbemSink, _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parametri

objWbemSink [in]: Sink oggetto che restituisce il risultato dell'operazione di eliminazione.
iFlags [in, facoltativo]: Intero che determina il comportamento della chiamata. Questo parametro può accettare i valori seguenti.
wbemFlagSendStatus (128 (0x80)): Causa chiamate asincrone per inviare gli aggiornamenti dello stato al gestore eventi SWbemSink.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 [in, facoltativo]

Questo parametro è in genere non definito. 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 [in, facoltativo]

Si tratta di un 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 questa chiamata ha esito positivo, il risultato dell'operazione di eliminazione viene fornito tramite il sink di oggetti fornito.

Codici di errore

Al termine del metodo DeleteAsync_ , l'oggetto Err può contenere uno dei codici di errore nell'elenco seguente.

wbemErrAccessDenied - 2147749891 (0x80041003): Il contesto corrente non dispone di diritti di sicurezza adeguati per eliminare l'oggetto.
wbemErrFailed - 2147749890 (0x80041002): Errore non specificato.
wbemErrInvalidClass - 2147749904 (0x80041010): La classe specificata non esiste.
wbemErrInvalidOperation - 2147749910 (0x80041016): Impossibile eliminare l'oggetto.
wbemErrNotFound - 2147749890 (0x80041002): L'oggetto non esiste.
wbemErrOutOfMemory - 2147749894 (0x80041006): Memoria insufficiente per completare l'operazione.

Commenti

Questa chiamata restituisce immediatamente. Lo stato viene restituito al chiamante tramite un callback recapitato al sink specificato in objWbemSink.

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 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	Wbemdisp.h
Libreria dei tipi	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Condividi tramite