Méthode CWbemProviderGlue ::GetInstancePropertiesByPath (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 GetInstancePropertiesByPath récupère les instance identifiées par un chemin d’accès d’objet particulier, avec uniquement les propriétés spécifiées renseignées. Les propriétés à remplir sont nommées dans un tableau CHString .

Syntaxe

HRESULT GetInstancePropertiesByPath(
        LPCWSTR         pszInstancePath,
        CInstance       **ppInstance,
        MethodContext   *pMethodContext,
  [ref] CHStringArray & csaProperties
);

Paramètres

pszInstancePath

Chemin d’accès de l’objet au instance à retourner. Ce paramètre doit pointer vers un chemin d’accès complet.

ppInstance

Pointeur vers un nouveau instance CInstance dont les clés sont celles spécifiées par pszInstancePath. 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.

[ref] csaProperties

Tableau qui contient les noms des propriétés à copier dans la nouvelle instance.

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 de instance partielle pour demander uniquement les propriétés spécifiées de l’objet spécifié. Il s’agit du moyen le plus efficace de récupérer un instance spécifique lorsque plus de propriétés que les clés sont nécessaires. N’oubliez pas que tous les fournisseurs ne prennent pas en charge les opérations de instance partiel. Dans ce cas, l’intégralité de la instance (y compris les clés) est renseignée. 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

GetInstanceKeysByPath