Metodo IWbemServices::D eleteInstanceAsync (wbemcli.h)
Il metodo IWbemServices::D eleteInstanceAsync elimina in modo asincrono un'istanza di una classe esistente nello spazio dei nomi corrente. La conferma o l'errore dell'operazione viene segnalata tramite l'interfaccia IWbemObjectSink implementata dal chiamante.
Sintassi
HRESULT DeleteInstanceAsync(
[in] const BSTR strObjectPath,
[in] long lFlags,
[in] IWbemContext *pCtx,
[in] IWbemObjectSink *pResponseHandler
);
Parametri
[in] strObjectPath
BSTR valido contenente il percorso dell'oggetto da eliminare.
[in] lFlags
WBEM_FLAG_SEND_STATUS registra con Windows Management una richiesta per ricevere report di stato intermedi tramite l'implementazione del client di IWbemObjectSink::SetStatus. L'implementazione del provider deve supportare la creazione di report sullo stato intermedio, per consentire a questo flag di modificare il comportamento. Si noti che il flag di WBEM_FLAG_USE_AMENDED_QUALIFIERS non può essere usato qui.
[in] pCtx
In genere NULL. In caso contrario, si tratta di un puntatore a un oggetto IWbemContext che può essere usato dal provider che elimina l'istanza. I valori nell'oggetto contesto devono essere specificati nella documentazione del provider in questione.
[in] pResponseHandler
Puntatore all'implementazione del chiamante di IWbemObjectSink. Questo gestore riceve lo stato dell'operazione di eliminazione perché diventa disponibile tramite il metodo SetStatus . Se viene restituito un codice di errore, il puntatore IWbemObjectSink specificato non viene usato. Se viene restituito WBEM_S_NO_ERROR, viene chiamata l'implementazione IWbemObjectSink dell'utente per indicare il risultato dell'operazione. Gestione Windows chiama solo AddRef nel puntatore nei casi in cui WBEM_S_NO_ERROR restituisce. Nei casi in cui viene restituito un codice di errore, il conteggio dei riferimenti corrisponde alla voce. Per altre informazioni, vedere Chiamata di un metodo.
Valore restituito
Questo metodo restituisce un HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in un HRESULT.
In caso di errore, è possibile ottenere informazioni disponibili dalla funzione COM GetErrorInfo.
Se DeleteInstanceAsync restituisce WBEM_S_NO_ERROR, WMI attende un risultato dal metodo SetStatus del gestore di risposta. WMI attende in modo indefinito una connessione locale o fino a quando non si verifica un timeout di connessione remota.
Altre condizioni di errore vengono segnalate in modo asincrono al sink di oggetti fornito dal parametro pResponseHandler .
I codici di errore specifici di COM possono essere restituiti anche se i problemi di rete causano la perdita della connessione remota a Gestione Windows.
Commenti
Un provider di istanze può segnalare l'esito positivo o negativo con il codice restituito da DeleteInstanceAsync o tramite una chiamata a SetStatus effettuata tramite pResponseHandler. Se inviato a SetStatus, il codice restituito inviato al sink tramite pResponseHandler ha la precedenza. Poiché il callback potrebbe non essere restituito allo stesso livello di autenticazione richiesto dal client, è consigliabile usare semisynchrono anziché la comunicazione asincrona. Se è necessaria la comunicazione asincrona, vedere Chiamata di un metodo.
Per altre informazioni sull'uso di metodi semisynchronously, vedere IWbemServices::D eleteInstance e Chiamata di un metodo.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | wbemcli.h (include Wbemidl.h) |
| Libreria | Wbemuuid.lib |
| DLL | Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll |