SWbemObject.SpawnDerivedClass_, méthode
Utilisez la méthode SpawnDerivedClass_ de l’objet SWbemObject pour créer un objet de classe dérivé à partir de l’objet actuel. L’objet doit être une définition de classe qui devient la classe parente de l’objet généré.
Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API de script.
Syntaxe
objNewClass = .SpawnDerivedClass_( _
[ ByVal iFlags ] _
)
Paramètres
-
iFlags [facultatif]
-
Réservé et doit être défini sur 0 (zéro) si spécifié.
Valeur retournée
Si l’appel réussit, l’objet SWbemObject contient le nouvel objet de définition de classe. Aucun objet n’est retourné en cas d’erreur.
Codes d’erreur
Au terme de l’exécution de la méthode SpawnDerivedClass_, l’objet Err peut contenir l’un des codes d’erreur de la liste suivante.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Erreur non spécifiée.
-
wbemErrIllegalOperation - 2147749918 (0x8004101E)
-
L’utilisateur a demandé une opération non autorisée, telle que la génération dynamique d’une classe à partir d’une instance.
-
wbemErrIncompleteClass - 2147749920 (0x80041020)
-
La classe source n’a pas été complètement définie ou inscrite auprès de WMI. Par conséquent, une nouvelle classe dérivée n’est pas autorisée.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
La mémoire disponible est insuffisante pour terminer cette opération.
Notes
L’objet retourné devient automatiquement une sous-classe de l’objet actuel. Ce comportement ne peut pas être substitué. Il n’existe aucune autre méthode permettant de créer des classes dérivées.
Vous ne pouvez pas créer une classe dérivée à partir d’une classe locale de votre propre processus client. Avant d’utiliser cette méthode pour créer une classe dérivée, vous devez créer la classe de base. Pour créer la classe de base, appelez SWbemObject.Put_ et récupérez la classe de base à l’aide de SWbemServices.Get.
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 |