Compartilhar via


Implementar a interface primária para um provedor de propriedades

Um provedor de propriedades usa os métodos IWbemPropertyProvider como a interface primária para o 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 métodos IWbemPropertyProvider que você pode implementar em um provedor de propriedades.

Método Recurso
GetProperty Recuperação
PutProperty Modification

 

Observação

Você deve implementar um provedor de propriedades como um provedor no processo. O WMI inicializará provedores de propriedades escritos como serviços ou arquivos executáveis, mas nunca chamará seus métodos GetProperty e PutProperty.

 

Se você optar por não dar suporte a um desses métodos, seu provedor poderá fornecer uma implementação de stub que retorna WBEM_E_PROVIDER_NOT_CAPABLE.

Um provedor de propriedades identifica uma classe gerenciada ou uma instância por um conjunto de três qualificadores: PropertyContext, InstanceContext e ClassContext. O WMI passará constantes de cadeia de caracteres que descrevem esses três qualificadores para o provedor de propriedades.

Seu provedor de propriedades 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 todas as propriedades da instância.
  • O qualificador ClassContext é anexado a uma classe e contém informações que se aplicam a todas as instâncias 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 pertencem à propriedade. Por exemplo, em uma classe usada para armazenar dados fornecidos pelo provedor do Registro, o PropertyContext especifica o nome do valor do Registro a ser armazenado pela propriedade.

Esses qualificadores podem trabalhar juntos. Você pode designar um valor de InstanceContext e PropertyContext para informar ao provedor como tratar tipos específicos de instâncias. Por exemplo, pode ser interessante marcar instâncias que o provedor reconhecerá como legíveis, mas com apenas uma propriedade gravável.

O qualificador mais comum usado é o PropertyContext. Portanto, o WMI fornece o qualificador DynProps como um atalho. O WMI considera cada propriedade em uma instância marcada com DynProps para também ter os qualificadores Dynamic, Provider e PropertyContext.