Méthode IWbemServices ::D eleteClass (wbemcli.h)

  • Article

La méthode IWbemServices ::D eleteClass supprime la classe spécifiée de l’espace de noms actuel. Si un fournisseur de instance dynamique est associé à la classe, le fournisseur n’est pas inscrit et il n’est plus appelé par cette classe. Toutes les classes qui dérivent de la classe supprimée sont également supprimées et leurs fournisseurs associés ne sont pas enregistrés. Toutes les instances statiques en suspens de la classe spécifiée et de ses sous-classes sont également supprimées lorsque la classe est supprimée.

Si un fournisseur de classe dynamique fournit la classe, la réussite de la suppression dépend de la prise en charge ou non de la suppression de classe par le fournisseur.

Note Les classes système ne peuvent pas être supprimées.
 

Syntaxe

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

Paramètres

[in] strClass

Nom de la classe ciblée pour suppression.

[in] lFlags

L’une des valeurs suivantes peut être définie.

WBEM_FLAG_RETURN_IMMEDIATELY

Cet indicateur fait qu’il s’agit d’un appel semi-synchronisé. Pour plus d’informations, consultez Appel d’une méthode.

WBEM_FLAG_OWNER_UPDATE

Indique que l’appelant est un fournisseur push.

[in] pCtx

Généralement NULL. Sinon, il s’agit d’un pointeur vers un objet IWbemContext qui peut être utilisé par le fournisseur qui supprime la classe. Les valeurs de l’objet de contexte doivent être spécifiées dans la documentation du fournisseur en question. Pour plus d’informations sur ce paramètre, consultez Effectuer des appels à WMI.

[out] ppCallResult

Si la valeur est NULL, ce paramètre n’est pas utilisé. Si ppCallResult est spécifié, il doit être défini pour pointer sur NULL lors de l’entrée. Si le paramètre lFlags contient WBEM_FLAG_RETURN_IMMEDIATELY, cet appel retourne immédiatement avec WBEM_S_NO_ERROR. Le paramètre ppCallResult reçoit un pointeur vers un nouvel objet IWbemCallResult , qui peut ensuite être interrogé pour obtenir le résultat à l’aide de la méthode GetCallStatus .

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

En cas d’échec, vous pouvez obtenir toutes les informations disponibles à partir de la fonction COM GetErrorInfo.

Des codes d’erreur spécifiques à COM peuvent également être retournés si des problèmes réseau vous font perdre la connexion à distance à Windows Management.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête wbemcli.h (inclure Wbemidl.h)
Bibliothèque 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

Voir aussi

IWbemServices

IWbemServices ::D eleteClassAsync

Récupération d’un code d’erreur