Metodo IWbemServices::D eleteClassAsync (wbemcli.h)

Articolo
08/27/2023

Il metodo IWbemServices::D eleteClassAsync elimina la classe specificata dallo spazio dei nomi corrente. Questo metodo è identico a IWbemServices::D eleteClass , ad eccezione del fatto che la chiamata restituisce immediatamente. La conferma o l'errore viene segnalata in modo asincrono al sink dell'oggetto specificato usando il metodo IWbemObjectSink::SetStatus al termine dell'operazione.

Sintassi

HRESULT DeleteClassAsync(
  [in] const BSTR      strClass,
  [in] long            lFlags,
  [in] IWbemContext    *pCtx,
  [in] IWbemObjectSink *pResponseHandler
);

Parametri

[in] strClass

Nome della classe di destinazione per l'eliminazione.

[in] lFlags

Uno o più dei valori seguenti sono validi.

WBEM_FLAG_SEND_STATUS

Questo flag viene registrato con Gestione Windows una richiesta di ricezione di rapporti di stato intermedi tramite l'implementazione del client di IWbemObjectSink::SetStatus. Per modificare il comportamento, l'implementazione del provider deve supportare la creazione di report sullo stato intermedio.

WBEM_FLAG_OWNER_UPDATE

I provider di push devono specificare questo flag quando si chiama DeleteClassAsync per indicare che questa classe è stata modificata.

[in] pCtx

In genere NULL. In caso contrario, si tratta di un puntatore a un oggetto IWbemContext che può essere utilizzato dal provider eliminando la classe . I valori nell'oggetto contesto devono essere specificati nella documentazione relativa al provider in questione. Per altre informazioni su questo parametro, vedere Effettuare chiamate a WMI.

[in] pResponseHandler

Puntatore a un'implementazione di IWbemObjectSink implementata dal chiamante. Questo gestore riceve lo stato della richiesta di eliminazione quando diventa disponibile tramite il metodo IWbemObjectSink::SetStatus . Se viene restituito un codice di errore, il puntatore IWbemObjectSink fornito 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 sul 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 a quello della voce. Per una spiegazione dettagliata di questo parametro, vedere Chiamata di un metodo.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in hrESULT.

Tutti gli altri codici restituiti vengono forniti al sink dell'oggetto specificato dal parametro pReponseHandler tramite il metodo SetStatus . Le condizioni di errore, ad esempio quando la classe non esiste o l'utente non dispone dell'autorizzazione per eliminare le classi, vengono segnalate al gestore. Non vengono segnalate nel codice restituito di questo metodo.

I codici di errore specifici di COM possono anche essere restituiti se i problemi di rete causano la perdita della connessione remota a Gestione Windows.

Commenti

Se alla classe è associato un provider di istanze dinamiche, il provider non viene registrato e non viene più chiamato per tale classe. Vengono eliminate anche tutte le classi che derivano dalla classe eliminata e i relativi provider associati vengono annullati. Tutte le istanze statiche in sospeso della classe specificata e le relative sottoclassi vengono eliminate anche quando la classe viene eliminata.

Se la classe viene fornita da un provider di classi dinamiche, l'esito positivo dell'eliminazione dipende dal fatto che l'eliminazione della classe sia supportata da tale provider.

Nota Le classi di sistema standard non possono essere eliminate.

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 semisynchronously dei metodi, vedere IWbemServices::D eleteClass 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

Iwbemservices

IWbemServices::D eleteClass

Recupero di un codice di errore

Condividi tramite