Méthode CWbemProviderGlue ::GetAllInstances (wbemglue.h)

Article
03/03/2024

[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 GetAllInstances récupère une liste d’instances retournées par une classe spécifique.

Syntaxe

HRESULT GetAllInstances(
  LPCWSTR                          pszClassName,
  TRefPointerCollection<CInstance> *pList,
  LPCWSTR                          pszNamespace,
  MethodContext                    *pMethodContext
);

Paramètres

pszClassName

Nom de la classe pour laquelle une liste d’instances doit être retournée.

pList

Liste liée d’instances prises en charge par le fournisseur spécifié par pszClassName.

pszNamespace

Espace de noms du fournisseur 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 ».

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.

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 d’un autre code d’erreur HRESULT .

Remarques

La méthode GetAllInstances permet aux fournisseurs d’infrastructure d’accéder aux données d’un autre fournisseur sans avoir à effectuer un appel d’API WMI. Les fournisseurs d’infrastructure transmettent le nom du fournisseur à GetAllInstances, qui retourne une liste de toutes les instances que le fournisseur prend en charge.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemglue.h (inclure FwCommon.h)
Bibliothèque	FrameDyn.lib
DLL	FrameDynOS.dll ; FrameDyn.dll

Partager via