Compartilhar via

Adicionando valores do Registro para um objeto Notify

  • Artigo

Um componente NetTrans, NetClient ou NetService pode ter um objeto de notificação que executa uma ou mais das seguintes ações:

  • Exibe uma interface do usuário para o componente

  • Notifica o componente de eventos de associação para que o componente possa exercer algum controle sobre o processo de associação

  • Instala ou remove condicionalmente componentes de software

Observação Os componentes do NetClient são preteridos em Windows 8.1, Windows Server 2012 R2 e posteriores.

Para obter mais informações sobre objetos de notificação, consulte Notificar objetos para componentes de rede.

ObservaçãoComponentes líquidos (adaptadores) não dão suporte a objetos de notificação; portanto, esses componentes devem usar um co-instalador.

Para obter mais informações sobre co-instaladores, consulte Escrevendo um co-instalador.

Se um componente tiver um objeto notify, o arquivo INF desse componente deverá adicionar (por meio de uma seção add-registry) os seguintes valores à chave Ndi do componente:

Clsid
Um valor REG_SZ que especifica o GUID (identificador global exclusivo) para o objeto notify. Obtenha esse GUID executando o utilitário uuidgen.exe. Para obter mais informações sobre esse utilitário, consulte o SDK do Microsoft Windows.

ComponentDll
Um valor REG_SZ que especifica o caminho para a DLL do objeto notify. O ComponentDll deve especificar o caminho completo para a DLL se a DLL não estiver no diretório Windows\System32.

Veja a seguir um exemplo de uma seção add-registry que adiciona valores ClsID e ComponentDll à chave Ndi :

[MS_Protocol.ndi.reg]
HKR, Ndi, ClsID, 0, "GUID"
HKR, Ndi, ComponentDll, 0, "notifyobject.dll"

A seção DDInstall para um componente que tem um objeto notify também deve conter uma diretiva CopyFiles que faz referência a uma seção de lista de arquivos que copia a DLL do objeto notify para o diretório de destino especificado pela seção DestinationDirs . Para obter mais informações sobre a diretiva CopyFiles e as seções DestinationDirs , consulte Seções e diretivas de arquivo INF.