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 |