Partager via

SpawnDerivedClass, fonction

  • Article

Crée un objet de classe dérivé à partir d’un objet spécifié.

Notes

Cette API est destinée à un usage interne uniquement. Elle n’est pas destinée à être utilisée dans le code du développeur.

Syntaxe

HRESULT SpawnDerivedClass (
   [in] int                  vFunc,
   [in] IWbemClassObject*    ptr,
   [in] LONG                 lFlags,
   [out] IWbemClassObject**  ppNewClass);

Paramètres

vFunc
[in] Ce paramètre est inutilisé.

ptr
[in] Pointeur vers une instance IWbemClassObject.

lFlags
[in] Réservée. Ce paramètre doit être 0.

ppNewClass
[out] Reçoit le pointeur vers le nouvel objet de définition de classe. Si une erreur se produit, aucun nouvel objet n’est retourné, et ppNewClass n’est pas modifié. Sa valeur ne peut pas être null.

Valeur retournée

Les valeurs suivantes renvoyées par cette fonction sont définies dans le fichier d’en-tête WbemCli.h, ou vous pouvez les définir comme constantes dans votre code :

Constant Valeur Description
WBEM_E_FAILED 0x80041001 Il y a eu une défaillance générale.
WBEM_E_INVALID_OPERATION 0x80041016 Une opération non valide, telle que la génération automatique d’une classe à partir d’une instance, a été demandée.
WBEM_E_INCOMPLETE_CLASS La classe source n’a pas été complètement définie ou inscrite auprès de Windows Management. Par conséquent, une nouvelle classe dérivée n’est pas autorisée.
WBEM_E_OUT_OF_MEMORY 0x80041006 La mémoire n'est pas suffisante pour terminer cette opération.
WBEM_E_INVALID_PARAMETER 0x80041008 ppNewClass est null.
WBEM_S_NO_ERROR 0 L’appel de fonction a abouti.

Notes

Cette fonction wrappe un appel à la méthode IWbemClassObject::SpawnDerivedClass.

ptr doit être une définition de classe qui devient la classe parente de l’objet généré. L’objet retourné devient une sous-classe de l’objet actuel.

Le nouvel objet retourné dans ppNewClass devient automatiquement une sous-classe de l’objet actuel. Ce comportement ne peut pas être substitué. Il n’existe aucune autre méthode par laquelle les sous-classes (classes dérivées) peuvent être créées.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : WMINet_Utils.idl

Versions de .NET Framework : disponibles depuis la version 4.7.2

Voir aussi