Méthode CWbemProviderGlue::GetEmptyInstance(MethodContext*,LPCWSTR,CInstance**,LPCWSTR) (wbemglue.h)

[La classe CWbemProviderGlue fait partie du framework de fournisseur WMI, qui est désormais considéré comme étant à l’état final. Aucun autre développement, aucune autre amélioration ou mise à jour ne sera disponible pour les problèmes non liés à la sécurité affectant ces bibliothèques. Les API MI doivent être utilisées pour tout nouveau développement.]

La méthode GetEmptyInstance récupère une seule instance non remplie de la classe spécifiée.

Syntaxe

HRESULT GetEmptyInstance(
  MethodContext *pMethodContext,
  LPCWSTR       pszClassName,
  CInstance     **ppInstance,
  LPCWSTR       pszNamespace
);

Paramètres

pMethodContext

Pointeur vers le contexte actuel.

pszClassName

Nom de la classe dont le instance doit être retourné.

ppInstance

Pointeur vers un instance de la classe CInstance utilisée pour stocker les nouvelles instance. Ce pointeur doit être libéré par le fournisseur d’infrastructure appelant GetEmptyInstance.

pszNamespace

Espace de noms du nom de classe spécifié par pszClassName. Ce paramètre peut avoir la valeur NULL pour indiquer l’espace de noms par défaut, qui est root\cimv2.

Valeur retournée

Retourne WBEM_S_NO_ERROR si l’opération a réussi, WBEM_E_OUT_OF_MEMORY si l’opération a échoué en raison d’un manque de mémoire ou de tout autre code d’erreur HRESULT .

Remarques

Le fournisseur d’infrastructure transmet le nom du fournisseur à GetEmptyInstance, qui retourne une instance vide. Une utilisation courante de cette méthode consiste à remplir une propriété d’objet incorporée. Cette méthode est utilisée conjointement avec CInstance::SetEmbeddedObject.

Le deuxième prototype de fonction n’est pas recommandé. Il est fourni uniquement pour prendre en charge le code existant.

Configuration requise