Implementando a interface principal para um provedor de propriedade
Um provedor de propriedade usa os métodos IWbemPropertyProvider como a interface principal para WMI. Com IWbemPropertyProvider, você pode implementar o código para recuperar e modificar propriedades de classe e instância.
A tabela a seguir lista os IWbemPropertyProvider métodos que você pode implementar para um provedor de propriedade.
| Método | Funcionalidade |
|---|---|
| ObterPropriedade | Recuperação |
| PutProperty | Modificação |
Observação
Você deve implementar um provedor de propriedade como um provedor em processo. WMI inicializará provedores de propriedade escritos como serviços ou ficheiros executáveis, mas nunca chamará seus métodos GetProperty e PutProperty.
Se você optar por não oferecer suporte a um desses métodos, seu provedor poderá fornecer uma implementação de stub que retorne WBEM_E_PROVIDER_NOT_CAPABLE.
Um provedor de propriedade identifica uma classe ou instância gerenciada por um conjunto de três qualificadores: PropertyContext, InstanceContexte ClassContext. O WMI passará constantes de string descrevendo esses três qualificadores para o seu provedor de propriedade.
Seu provedor de propriedade deve estar preparado para lidar com os seguintes tipos de qualificadores de contexto:
- O qualificador InstanceContext é anexado a uma instância e contém informações que se aplicam a cada propriedade na instância.
- O qualificador ClassContext é anexado a uma classe e contém informações que se aplicam a cada instância da classe. Por exemplo, em uma classe usada para armazenar dados fornecidos pelo provedor do Registro, ClassContext pode ser o caminho para a chave do Registro que contém as propriedades a serem relatadas.
- O qualificador PropertyContext especifica informações específicas do contexto que se relacionam com a propriedade. Por exemplo, em uma classe usada para armazenar dados fornecidos pelo provedor do Registro, PropertyContext especifica o nome do valor do Registro a ser armazenado pela propriedade.
Estes qualificadores podem funcionar em conjunto. Você pode atribuir tanto um InstanceContext quanto um valor de PropertyContext para informar ao fornecedor como tratar tipos particulares de instâncias. Por exemplo, talvez você queira marcar instâncias que o provedor reconhecerá como legíveis, mas com apenas uma propriedade gravável.
O qualificador mais comum usado é PropertyContext. Portanto, o WMI fornece o qualificador DynProps como um atalho. O WMI considera que cada propriedade numa instância marcada com DynProps também tenha os qualificadores Dynamic, Providere PropertyContext.