Méthode CWbemProviderGlue ::GetInstanceKeysByPath (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 GetInstanceKeysByPath récupère les instance identifiées par un chemin d’objet particulier, avec uniquement les propriétés de clé renseignées.

Syntaxe

HRESULT GetInstanceKeysByPath(
  LPCWSTR       pszInstancePath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Paramètres

pszInstancePath

Chemin d’accès de l’objet au instance à retourner.

ppInstance

Pointeur vers un nouveau instance CInstance dont les clés sont celles spécifiées dans pszInstancePath. Le fournisseur d’infrastructure qui effectue la requête doit libérer ce pointeur.

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.

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

Cette méthode utilise des opérations de mise à jour partielles instance pour demander uniquement les propriétés de clé de l’objet spécifié. Il s’agit du moyen le plus efficace de vérifier l’existence d’un objet spécifique. N’oubliez pas que tous les fournisseurs ne prennent pas en charge les opérations de instance partiel. Dans ce cas, la totalité de la instance est remplie. Pour plus d’informations, consultez Prise en charge des opérations Partial-Instance.

Dans la version actuelle de l’infrastructure du fournisseur, pszInstancePath doit être résolu pour être un chemin d’accès instance sur le même ordinateur.

Configuration requise

Voir aussi

CWbemProviderGlue

GetInstanceByPath

GetInstancePropertiesByPath