IWbemClassObject ::Clone, méthode (wbemcli.h)

La méthode IWbemClassObject ::Clone retourne un nouvel objet qui est un clone complet de l’objet actuel. Le nouveau objet a un nombre de références COM de 1.

Syntaxe

HRESULT Clone(
  [out] IWbemClassObject **ppCopy
);

Paramètres

[out] ppCopy

Ce paramètre ne peut pas être NULL. Il reçoit la copie de l’objet actuel. Vous devez appeler IWbemClassObject ::Release sur cet objet quand il n’est plus nécessaire.

Un nouvel objet n’est pas retourné en cas d’erreur.

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. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Remarques

Utilisez cette méthode pour dupliquer une définition de classe ou pour dupliquer une instance. Cela peut être utile lorsque la copie d’origine de l’objet est nécessaire à des fins de sauvegarde lors de la modification d’une nouvelle copie. De même, utilisez cette méthode pour créer de nombreuses instances à partir d’une seule source instance. Par exemple, utilisez IWbemClassObject ::SpawnInstance pour créer une seule instance de départ, et utilisez IWbemClassObject ::Clone pour produire rapidement 100 copies du instance. Chaque objet peut être modifié par la suite pour prendre ses valeurs particulières.

Il n’est pas possible d’utiliser cette méthode pour convertir une définition de classe en instance ou convertir un instance en définition de classe.

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 (include Wbemidl.h)
Bibliothèque	WbemUuid.lib
DLL	CIMWin32.dll ; Esscli.dll ; Fastprox.dll ; FrameDyn.dll ; FrameDynOS.dll ; Krnlprov.dll ; Ncprov.dll ; Wbemcore.dll ; Wbemess.dll ; Wmipiprt.dll