Metodo IWbemServices::D eleteClass (wbemcli.h)

Articolo
03/03/2024

Il metodo IWbemServices::D eleteClass elimina la classe specificata dallo spazio dei nomi corrente. Se alla classe è associato un provider di istanze dinamiche, il provider non viene registrato e non viene più chiamato per da tale classe. Vengono eliminate anche tutte le classi che derivano dalla classe eliminata e i relativi provider associati non vengono registrati. Tutte le istanze statiche in sospeso della classe specificata e le relative sottoclassi vengono eliminate anche quando la classe viene eliminata.

Se un provider di classi dinamiche fornisce la classe , l'esito positivo dell'eliminazione dipende dal fatto che il provider supporti l'eliminazione della classe.

Nota Le classi di sistema non possono essere eliminate.

Sintassi

HRESULT DeleteClass(
  [in]  const BSTR      strClass,
  [in]  long            lFlags,
  [in]  IWbemContext    *pCtx,
  [out] IWbemCallResult **ppCallResult
);

Parametri

[in] strClass

Nome della classe di destinazione per l'eliminazione.

[in] lFlags

È possibile impostare uno dei valori seguenti.

WBEM_FLAG_RETURN_IMMEDIATELY

Questo flag fa sì che si tratta di una chiamata semiincrona. Per altre informazioni, vedere Chiamata di un metodo.

WBEM_FLAG_OWNER_UPDATE

Indica che il chiamante è un provider di push.

[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.

[out] ppCallResult

Se NULL, questo parametro non viene usato. Se si specifica ppCallResult , deve essere impostato su NULL nella voce. Se il parametro lFlags contiene WBEM_FLAG_RETURN_IMMEDIATELY, questa chiamata restituisce immediatamente con WBEM_S_NO_ERROR. Il parametro ppCallResult riceve un puntatore a un nuovo oggetto IWbemCallResult , che può quindi essere sottoposto a polling per ottenere il risultato usando il metodo GetCallStatus .

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.

In caso di errore, è possibile ottenere qualsiasi informazione disponibile dalla funzione COM GetErrorInfo.

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.

Requisiti

Requisito	Valore
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 eleteClassAsync

Recupero di un codice di errore

Condividi tramite