Compartilhar via


Registrar um provedor de propriedades

Para criar um provedor de propriedades WMI, você deve registrar a instância __Win32Provider que representa seu provedor usando uma instância de __PropertyProviderRegistration. Como um objeto COM, seu provedor deve se registrar no sistema operacional e no WMI. O procedimento a seguir pressupõe que você já tenha implementado o processo de registro, conforme descrito em Registrar um provedor.

O procedimento a seguir descreve como registrar um provedor de propriedades.

Para registrar um provedor de propriedades

  1. Crie uma instância da classe __Win32Provider que descreve o provedor de propriedades.

    A classe __Win32Provider aceita os valores padrão para outras propriedades, como o valor TRUE da propriedade Pure. Para obter mais informações, confira __Win32Provider.

  2. Crie uma instância da classe __PropertyProviderRegistration que descreve o conjunto de recursos do provedor.

    A classe __PropertyProviderRegistration herda muitas propriedades da classe pai __ObjectProviderRegistration, que fornece valores boolianos que indicam suporte a recursos específicos e uma matriz de cadeias de caracteres para indicar o suporte à consulta.

    Certifique-se de marcar a classe com os qualificadores Dynamic e Provider. O qualificador Dynamic sinaliza que o WMI deve usar um provedor dinâmico para recuperar as instâncias de classe que contêm as propriedades com suporte. O qualificador Provider especifica o nome do provedor que o WMI deve usar.

O WMI chama NewQuery em um provedor de eventos quando um consumidor cliente registra uma consulta de filtro de evento que contém referências a eventos compatíveis com esse provedor de eventos. Portanto, o provedor de eventos responsável por eventos de modificação de instância para a classe EmailClass pode ser configurado para gerar notificações somente para o remetente. Quando o provedor recebe uma consulta solicitando a notificação de alterações na propriedade assunto, o provedor pode começar a gerar essas notificações. Nesse cenário, não é necessário que o WMI descarte as notificações que relatam mudanças apenas no destinatário.

O exemplo de código MOF a seguir descreve instâncias que podem ser usadas para registrar um provedor de propriedades.

  instance of __Win32Provider as $P
  {
    Name    = "PropProvider" ;
    ClsId   = "{E30EC6A0-23CF-11d1-8FDE-0000F804AA5C}" ;
  };    

  instance of __PropertyProviderRegistration
  {
    Provider = $P;
    SupportsGet = TRUE;
    SupportsPut = FALSE;
  };

Observação

Somente os administradores podem registrar ou excluir um provedor de propriedades criando uma instância de __Win32Provider e __PropertyProviderRegistration.