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.

Nota I client che chiamano DeleteInstanceAsync devono sempre prevedere che i risultati della chiamata vengano segnalati usando il metodo IWbemObjectSink::Indicate .

 

Nota Quando l'istanza puntata da strObjectPath appartiene a una classe che è un membro di una gerarchia di classi, il successo di DeleteInstanceAsync dipende dal provider non astratto più alto. Per una spiegazione dettagliata delle dipendenze coinvolte che determinano l'esito positivo di questa operazione, vedere Osservazioni in IWbemServices::D eleteInstance.

 

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

Vedi anche

Chiamata di un metodo

Descrizione di un percorso dell'oggetto istanza

Iwbemservices

IWbemServices::D eleteInstance