Diretiva INF RegisterDlls
Observação
Se você estiver criando um pacote de driver universal ou móvel, essa diretiva não será válida. Você pode usar a ferramenta Reg2inf para converter diretivas INF RegisterDlls existentes em diretivas InF AddReg para tornar um pacote de driver universal. Para obter mais informações, consulte Usando um arquivo INF Universal.
Uma diretiva RegisterDlls faz referência a uma ou mais seções INF usadas para especificar arquivos que são controles OLE e exigem o auto-registro.
[DDInstall]
RegisterDlls=register-dll-section[,register-dll-section]...
Cada seção INF referenciada por uma diretiva RegisterDlls deve ter o seguinte formato de entrada:
[register-dll-section]
dirid,[subdir],filename,registration-flags[,[timeout][,argument]]
Uma seção register-dll pode ter qualquer número de entradas, cada uma em uma linha separada.
Entradas
dirid
Especifica a ID do diretório de destino do arquivo a ser registrado. Para obter mais informações, consulte Usando Dirids.
Subdir
Especifica o caminho do diretório, relativo ao diretório atual, para o arquivo a ser registrado. Se não for especificado, o arquivo estará no diretório atual.
filename
Identifica o nome do arquivo do controle OLE a ser registrado.
registration-flags
Indica as operações de registro a serem executadas no controle OLE. Um ou ambos os sinalizadores a seguir devem ser especificados.
0x00000001 (FLG_REGSVR_DLLREGISTER)
Chame a função DllRegisterServer do controle OLE (descrita na documentação do SDK do Windows).
0x00000002 (FLG_REGSVR_DLLINSTALL)
Chame a função DllInstall do controle OLE (descrita na documentação do SDK do Windows).
timeout
Especifica o tempo limite, em unidades de segundos, para que um Controle OLE conclua as chamadas de registro especificadas. O tempo limite padrão é de 60 segundos.
argument
Se o controle for um arquivo executável, essa será uma cadeia de caracteres de comando que é passada para o executável. O argumento padrão é /RegServer.
Se o controle não for um arquivo executável, isso especificará o argumento de linha de comando a ser passado para a função DllInstall .
Comentários
Cada nome de seção register-dll deve ser exclusivo para o arquivo INF e deve seguir as regras gerais para definir nomes de seção. Para obter mais informações sobre essas regras, consulte Regras gerais de sintaxe para arquivos INF.
As regras a seguir se aplicam ao uso da diretiva RegisterDlls para instalações de dispositivo:
Embora a sintaxe permita que o nome do arquivo seja uma DLL ou um arquivo executável, para instalações de dispositivo apenas uma DLL é permitida.
O código a ser registrado não deve solicitar a entrada do usuário.
Instalações do lado do servidor são executadas em um contexto do sistema. Portanto, você deve ter certeza de que o código que está sendo registrado não contém nenhuma vulnerabilidade de segurança e que as permissões de arquivo impedem que o código seja modificado maliciosamente.
Para obter mais informações sobre controles OLE e auto-registro, consulte a documentação do SDK do Windows.
Exemplos
[Dialer]
RegisterDlls = DialerRegSvr
[DialerUninstall]
UnregisterDlls = DialerRegSvr
[DialerRegSvr]
11,,avtapi.dll, 1