Méthode SWbemObject.Clone_

La méthode Clone_ de l'objet SWbemObject renvoie un nouvel objet qui est un clone de l'objet actuel.

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API de script.

Syntaxe

objWbemObject = .Clone_( _
)

Paramètres

Cette méthode n’a aucun paramètre.

Valeur retournée

Si elle réussit, cette méthode retourne un nouvel objet SWbemObject .

Codes d’erreur

Une fois la méthode Clone_ terminée, l’objet Err peut contenir l’un des codes d’erreur ci-dessous.

wbemErrFailed - 2147749889 (0x80041001)

Erreur non spécifiée.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Rien n’a été spécifié en tant que paramètre, et il n’est pas acceptable dans cette utilisation.

wbemErrOutOfMemory - 2147749894 (0x80041006)

Mémoire insuffisante pour cloner l’objet.

Notes

Utilisez la méthode Clone_ pour dupliquer une définition de classe ou un instance. Cela est utile lorsque vous avez besoin de la copie d’origine de l’objet à des fins de sauvegarde pendant que vous modifiez 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 SWbemObject.SpawnInstance_ pour créer un instance de démarrage unique et utilisez SWbemObject.Clone_ pour produire rapidement 100 copies du instance. Par la suite, vous pouvez modifier les objets, en donnant à chacun d'eux des valeurs spécifiques.

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Wbemdisp.h
Bibliothèque de types	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject