SWbemObject.SpawnInstance_, méthode

Utilisez la méthode SpawnInstance_ de l’objet SWbemObject pour créer une instance d’une classe. L’objet actuel doit être une définition de classe obtenue à partir de WMI au moyen d’une méthode telle que SWbemServices.Get ou SWbemServices.ExecQuery. Ensuite, utilisez cette définition de classe pour créer des instances. Créez chaque instance localement dans le processus, puis appelez SWbemObject.Put_ pour créer l’instance dans WMI.

Notes

La génération d’une instance à partir d’une instance est prise en charge, mais l’instance retournée est vide.

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

Syntaxe

objNewInstance = .SpawnInstance_( _
  [ ByVal iFlags ] _
)

Paramètres

iFlags [entier, facultatif]

Réservé et doit être égal à zéro si spécifié.

Valeur retournée

En cas de réussite, cet appel retourne un objet SWbemObject qui contient une nouvelle instance de la classe.

Codes d’erreur

Au terme de l’exécution de la méthode SpawnInstance_, l’objet Err peut contenir l’un des codes d’erreur de la liste suivante.

wbemErrIncompleteClass - 2147749920 (0x80041020)

L’objet actuel n’est pas une définition de classe valide et ne peut pas générer de nouvelles instances. Soit il est incomplet, soit il n’a pas été inscrit auprès de WMI avec SWbemObject.Put_.

wbemErrIllegalOperation - 2147749918 (0x8004101E)

Retourné si cette méthode est utilisée sur une instance au lieu d’une classe.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Un paramètre non valide a été spécifié.

wbemErrOutOfMemory - 2147749894 (0x80041006)

La mémoire disponible est insuffisante pour terminer cette opération.

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

Voir aussi

SWbemObject

SWbemObject.Put_

SWbemServices.Get