Méthode IWbemClassObject::SpawnInstance (wbemcli.h)

  • Article

Utilisez la méthode IWbemClassObject::SpawnInstance pour créer un instance d’une classe. L’objet actuel doit être une définition de classe obtenue à partir de Windows Management à l’aide de IWbemServices::GetObject, IWbemServices::CreateClassEnum ou IWbemServices::CreateClassEnumAsync Ensuite, utilisez cette définition de classe pour créer de nouvelles instances.

Un appel à IWbemServices::P utInstance est nécessaire pour écrire le instance dans Windows Management. Si vous envisagez d’ignorer l’objet avant d’appeler IWbemServices::P utInstance, il vous suffit d’appeler IWbemClassObject::Release.

Notez que la génération d’un instance à partir d’un instance est prise en charge, mais que le instance retourné est vide.

Syntaxe

HRESULT SpawnInstance(
  [in]  long             lFlags,
  [out] IWbemClassObject **ppNewInstance
);

Paramètres

[in] lFlags

Réservé. Ce paramètre doit être 0.

[out] ppNewInstance

Impossible d’avoir la valeur NULL. Il reçoit une nouvelle instance de la classe. L’appelant doit appeler IWbemClassObject::Release lorsque le pointeur n’est plus requis. En cas d’erreur, un nouvel objet n’est pas retourné et le pointeur reste inchangé.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Configuration requise

   
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête wbemcli.h (inclure Wbemidl.h)
Bibliothèque WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Voir aussi

IWbemClassObject

IWbemServices::GetObject

IWbemServices::PutInstance