SWbemObject.SpawnDerivedClass_, méthode

Article
06/29/2023

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	Wbemdisp.h
Bibliothèque de types	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Partager via