Méthode CWbemProviderGlue::GetInstanceByPath(LPCWSTR,CInstance**,MethodContext*) (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 GetInstanceByPath récupère les instance identifiées par un chemin d’objet particulier en appelant la méthode GetObject du fournisseur.

Syntaxe

HRESULT GetInstanceByPath(
  LPCWSTR       pszObjectPath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Paramètres

pszObjectPath

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

ppInstance

Pointeur vers un pointeur vers un instance CInstance utilisé pour stocker la nouvelle instance. Le fournisseur d’infrastructure qui effectue la demande 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

La méthode GetInstanceByPath permet aux fournisseurs d’infrastructure d’accéder aux données d’un autre fournisseur sans nécessiter d’appel d’API WMI. Les fournisseurs d’infrastructure passent le chemin d’objet d’un instance à GetInstanceByPath, qui retourne le 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.

Bien que pMethodContext ait une valeur par défaut NULL, 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.

Configuration requise