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 |
|
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |