Partilhar via


Definir uma classe de registro com qualificadores

As classes usadas para armazenar dados do Registro são definidas com vários qualificadores padrão.

Veja a seguir uma lista dos qualificadores padrão:

  • Dynamic e Provider

    Você pode anexar o qualificador Dynamic a uma classe ou a uma instância. O qualificador Dynamic marca a classe ou instância como gerenciada dinamicamente por um provedor. Quando Dynamic aparece em uma classe ou instância, o qualificador Provider também deve aparecer. O qualificador Provider identifica o provedor específico que deve gerenciar a classe ou instância dinâmica.

  • ClassContext

    O qualificador ClassContext está anexado a uma classe. Ele especifica o caminho para a chave de registro que contém as informações que a classe representa.

    O qualificador ClassContext tem o seguinte formato.

    MACHINE_NAME|Subtree\\KeyPath
    

    O valor de KeyPath poderá ser longo se incluir chaves com subchaves.

    O exemplo a seguir mostra o qualificador ClassContext que contém o caminho para um dispositivo de transporte de computador específico.

    Machine_Name|HKEY_LOCAL_MACHINE\\SOFTWARE\\MICROSOFT\\WBEM\\TRANSPORTS
    

O modelo a seguir para uma definição de classe ilustra o uso dos qualificadores Dynamic, Provider e ClassContext. O provedor nomeado pelo qualificador Provider é o provedor do registro do sistema da instância. Lembre-se de que os caminhos do registro não diferenciam maiúsculas de minúsculas, assim como os nomes do qualificador.

[dynamic, provider("RegProv"), 
    ClassContext("local|hkey_local_machine\\software\\microsoft
    \\WBEM\\transports\\Network Transport Modules")]

class RegTrans
{
  [key] string  TransportsGUID;
  [PropertyContext("Name")] string Name;
  [PropertyContext("Independent")] uint32 Enabled;
};

Os aplicativos de gerenciamento também podem usar o provedor do registro do sistema para recuperar e modificar dados do registro para uma chave específica.