Registrando extensões de classe auxiliar do NDF

  • Artigo

Cada extensão de classe auxiliar tem várias chaves do Registro associadas a ela. Algumas chaves são exigidas pelo COM e algumas chaves são exigidas pelo NDF.

Chaves do Registro COM

As extensões de classe auxiliar devem ser implementadas como servidores COM. O registro COM deve ser concluído para cada extensão de classe auxiliar. O CLSID do objeto, a interface INetDiagHelperInfo e a interface INetDiagHelper devem ser registrados. O registro cria várias chaves do Registro relacionadas ao COM para a extensão de classe auxiliar do NDF.

Chaves do Registro NDF

As extensões de classe auxiliar devem ser registradas antes de interagir com o Network Diagnostics Framework e com outras classes auxiliares relacionadas. Isso é feito preenchendo o registro.

O procedimento a seguir mostra como adicionar extensões de classe auxiliar ao registro.

  1. Publique os nomes das classes auxiliares implementadas pela DLL e suas dependências criando uma chave para a DLL em

    HKLM\System\CurrentControlSet\Control\NetDiagFx\VendorName\HostDLLs\DLL\ da classe auxiliar HelperClasses\Nome da classe auxiliar

    Substitua VendorName, DLL da Classe Auxiliar e Nome da Classe Auxiliar por valores definidos pelo usuário, conforme descrito abaixo.

    Valor Type Significado
    VendorName REG_SZ O nome do fornecedor.
    DLL da classe auxiliar REG_SZ Nome da DLL, sem extensão.
    Nome da classe auxiliar REG_SZ O nome da classe auxiliar na qual a classe auxiliar atual é dependente.

     

  2. Em cada chave nome de classe auxiliar , publique as informações a seguir.

    Valor Type Significado
    CLSID REG_SZ Uma cadeia de caracteres que contém a ID de classe COM da classe auxiliar.
    Versão REG_SZ Uma cadeia de caracteres que contém as versões principais e secundárias da classe auxiliar no formato <principal><secundário>.
    Publicado REG_DWORD Um valor de 1 significa que espera-se que essa classe auxiliar seja invocada diretamente do cliente de Diagnóstico. 0 significa que ele só pode ser chamado de outra classe auxiliar.
    Pai REG_SZ Uma cadeia de caracteres que nomeia a classe auxiliar extensível da Microsoft que está sendo estendida.

     

  3. Para cada classe auxiliar, publique a lista de atributos correspondentes criando uma chave em

    HKLM\System\CurrentControlSet\Control\NetDiagFx\VendorName\HostDLLs\DLL\ da classe auxiliar HelperClasses\ Nome \da classe auxiliarMatchAttributes

    A chave deve conter um ou mais valores (um por atributo) do tipo a seguir.

    Valor Type Significado
    AttributeName REG_SZ| REG_DWORD| REG_BINARY Um valor que conclui o par de nome e valor de um atributo específico.