SWbemObject. SpawnInstance, _ méthode

Utilisez la méthode _ SpawnInstance de l’objet SWbemObject pour créer une nouvelle instance d’une classe. L’objet actuel doit être une définition de classe obtenue à partir de WMI via une méthode telle que SWbemServices. obtenir ou SWbemServices.ExecQuery. Utilisez ensuite cette définition de classe pour créer des instances. Créez chaque nouvelle instance localement au sein du processus, puis appelez SWbemObject. put _ pour réellement 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 une explication de cette syntaxe, consultez conventions de document pour l’API de script.

Syntaxe

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

Paramètres

IFlags [ dans, facultatif]

Réservé et doit être égal à zéro s’il est 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

À la fin de la méthode _ SpawnInstance , l’objet Err peut contenir l’un des codes d’erreur répertoriés dans 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 à l’aide de 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)

Mémoire insuffisante pour terminer l’opération.

Configuration requise

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

M

SWbemObject. put_

SWbemServices.