Implémentation de l’interface principale pour un fournisseur de propriétés

Un fournisseur de propriétés utilise les méthodes IWbemPropertyProvider comme interface principale pour WMI. Avec IWbemPropertyProvider, vous pouvez implémenter le code pour récupérer et modifier les propriétés de classe et d’instance.

Le tableau suivant répertorie les méthodes IWbemPropertyProvider que vous pouvez implémenter pour un fournisseur de propriétés.

Méthode	Fonctionnalité
GetProperty	Récupération
PutProperty	Modification

 

Notes

Vous devez implémenter un fournisseur de propriétés en tant que fournisseur in-process. WMI initialise les fournisseurs de propriétés écrits en tant que services ou fichiers exécutables, mais n’appelle jamais leurs méthodes GetProperty et PutProperty.

 

Si vous choisissez de ne pas prendre en charge l’une de ces méthodes, votre fournisseur peut fournir une implémentation de stub qui retourne WBEM_E_PROVIDER_NOT_CAPABLE.

Un fournisseur de propriétés identifie une classe managée ou une instance par un ensemble de trois qualificateurs : PropertyContext, InstanceContext et ClassContext. WMI transmet des constantes de chaîne décrivant ces trois qualificateurs à votre fournisseur de propriétés.

Votre fournisseur de propriétés doit être prêt à gérer les types suivants de qualificateurs de contexte :

• Le qualificateur InstanceContext est attaché à une instance et contient des informations qui s’appliquent à chaque propriété dans l’instance.
• Le qualificateur ClassContext est attaché à une classe et contient des informations qui s’appliquent à chaque instance de la classe. Par exemple, dans une classe utilisée pour stocker les données fournies par le fournisseur de registre, ClassContext peut être le chemin d’accès à la clé de registre qui contient les propriétés à signaler.
• Le qualificateur PropertyContext spécifie des informations spécifiques au contexte qui se rapportent à la propriété. Par exemple, dans une classe utilisée pour stocker les données fournies par le fournisseur de registre, PropertyContext spécifie le nom de la valeur de registre à stocker par la propriété .

Ces qualificateurs peuvent fonctionner ensemble. Vous pouvez désigner à la fois une valeur InstanceContext et PropertyContext pour indiquer au fournisseur comment traiter des types particuliers d’instances. Par exemple, vous pouvez marquer les instances que le fournisseur reconnaît comme lisibles, mais n’ayant qu’une seule propriété accessible en écriture.

Le qualificateur le plus couramment utilisé est PropertyContext. Par conséquent, WMI fournit le qualificateur DynProps comme raccourci. WMI considère que chaque propriété d’une instance marquée avec DynProps comme ayant également les qualificateurs Dynamic, Provider et PropertyContext.