Méthode CWbemProviderGlue ::GetInstancesByQuery(LPCWSTR,TRefPointerCollection<CInstance>*,MethodContext*,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 dans tout nouveau développement.]

La méthode GetInstancesByQuery récupère une liste d’instances qui correspondent à une requête particulière.

Syntaxe

HRESULT GetInstancesByQuery(
  LPCWSTR                          query,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

Paramètres

query

Requête à exécuter.

pList

Liste liée d’instances qui correspondent à la requête spécifiée par Query.

pMethodContext

Pointeur vers le contexte actuel. Un contexte doit être fourni pour éviter les interblocages. Utilisez le contexte transmis au fournisseur par Provider ::EnumerateInstances ou Provider ::ExecQuery, ou bien obtenez-le à partir du instance à l’aide de CInstance ::GetMethodContext. Ce paramètre ne doit pas avoir la valeur NULL.

pszNamespace

Pointeur vers l’espace de noms qui contient les instances. Si la valeur est NULL, l’espace de noms par défaut cimv2 racine\est utilisé.

Valeur retournée

La méthode retourne WBEM_S_NO_ERROR si l’opération a réussi, WBEM_E_FAILED si l’opération a échoué ou tout autre code d’erreur HRESULT .

Remarques

La méthode GetInstancesByQuery permet aux fournisseurs d’infrastructure d’accéder aux données d’autres fournisseurs sans avoir à effectuer un appel d’API WMI. Les fournisseurs d’infrastructure transmettent une requête à GetInstancesByQuery, qui retourne les instances appropriées.

Pour des raisons de performances, lors de l’appel de cette fonction, spécifiez uniquement les propriétés dont vous avez besoin (par exemple, spécifiez « SELECT name » au lieu de « SELECT * »).

Configuration requise