Méthode CWbemProviderGlue ::GetAllDerivedInstances(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 GetAllDerivedInstances récupère une liste d’instances d’une classe de base ou de tous les enfants de cette classe de base.

Syntaxe

HRESULT GetAllDerivedInstances(
  LPCWSTR                          pszBaseClassName,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

Paramètres

pszBaseClassName

Pointeur vers le nom de la classe de base pour laquelle la liste doit être retournée.

pList

Pointeur vers la liste liée d’instances dérivées de la classe spécifiée par pszBaseClassName.

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 obtenez-le à partir du instance à l’aide de CInstance ::GetMethodContext. Ce paramètre ne doit pas être NULL.

pszNamespace

Espace de noms du nom de classe spécifié par pszBaseClassName. Lorsque ce paramètre a la valeur NULL, l’espace de noms par défaut root\cimv2 est utilisé.

Valeur retournée

La méthode 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 tout autre code d’erreur HRESULT .

Remarques

La méthode GetAllDerivedInstances permet aux fournisseurs d’infrastructure d’accéder aux données d’autres fournisseurs. Les fournisseurs d’infrastructure passent le nom d’une classe de base à GetAllDerivedInstances, qui retourne une liste de toutes les instances qui en dérivent.

Les codes de retour incluent tous les retours possibles à partir d’IWbemServices ::ExecQuery.

Cette méthode est sémantiquement équivalente à la requête SELECT * FROM pszBaseClassName.

Configuration requise