Implementando 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 o IWbemPropertyProvider, você pode implementar o código para recuperar e modificar as propriedades de classe e instância.

A tabela a seguir lista os métodos IWbemPropertyProvider que você pode implementar para um provedor de propriedades.

Método Recurso
GetProperty Recuperação
PutProperty Modification

Observação

Você deve implementar um provedor de propriedades como um provedor em processo. O WMI inicializará os provedores de propriedades gravados como serviços ou arquivos 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 o _ provedor WBEM E _ _ não _ compatível.

Um provedor de propriedades identifica uma classe ou instância gerenciada por um conjunto de três qualificadores: PropertyContext, InstanceContext e ClassContext. O WMI passará constantes de cadeia de caracteres descrevendo esses três qualificadores para seu 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 na instância.
  • O qualificador ClassContext é anexado a uma classe e contém informações que se aplicam a todas as instâncias na classe. Por exemplo, em uma classe usada para armazenar dados fornecidos pelo provedor de 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 de contexto que pertencem à propriedade. Por exemplo, em uma classe usada para armazenar dados fornecidos pelo provedor de registro, 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, talvez você queira marcar instâncias que o provedor reconhecerá como legível, mas tendo 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 em uma instância marcada com DynProps também tem os qualificadores dinâmico, Providere PropertyContext .