Méthode Provider ::GetObject(CInstance*,long,CFrameworkQuery&) (provider.h)

[La classe Provider fait partie de L’infrastructure de fournisseur WMI, qui est maintenant considérée dans l’état final, et aucun développement, amélioration ou mise à jour supplémentaire ne sera disponible pour les problèmes non liés à la sécurité affectant ces bibliothèques. Les API MI doivent être utilisées dans tout nouveau développement.]

La méthode GetObject est appelée par WMI pour récupérer un instance d’une classe.

Syntaxe

HRESULT GetObject(
        CInstance         *pInstance,
  [ref] long              lFlags,
        CFrameworkQuery & Query
);

Paramètres

pInstance

TBD

[ref] lFlags

Objet de requête qui indique l’ensemble de propriétés à remplir, comme demandé par un appel à Provider ::GetObject.

Un fournisseur peut réaliser un gain de performances significatif en remplissant uniquement ces valeurs de propriété demandées. Le fournisseur détermine les propriétés demandées à l’aide de CFrameworkQuery ::IsPropertyRequired. Sinon, le fournisseur doit remplir toutes les valeurs de propriété.

Query

TBD

Valeur retournée

L’implémentation du fournisseur d’infrastructure par défaut de cette méthode retourne WBEM_E_PROVIDER_NOT_CAPABLE à la méthode appelante. La méthode IWbemServices ::GetObject répertorie les valeurs de retour courantes, bien que vous puissiez choisir d’implémenter n’importe quelle valeur de retour COM.

Remarques

WMI appelle souvent GetObject en réponse à un appel client à IWbemServices ::GetObject. La version WMI de Provider ::GetObject fournit une instance avec uniquement les propriétés de clé renseignées. En revanche, un fournisseur d’infrastructure implémenté doit remplir toutes les autres propriétés. Ce qui suit décrit une substitution courante de GetObject :

1. Déterminez les instance WMI demandés en lisant les propriétés de clé avec une méthode Get à partir de CInstance, telle que CInstance ::GetCHString.
2. Renseignez le reste des propriétés du instance à l’aide des nombreuses méthodes Set de la classe CInstance, telles que CInstance ::SetByte ou CInstance ::SetStringArray.

Configuration requise