Partilhar via


Diretiva INF RegisterDlls

Atenção

A partir da versão 22H2 do Windows 11, um pacote de driver de usando essa diretiva não é mais elegível para uma assinatura do Hardware Developer Center.

Pacotes de drivers universais e Drivers do Windows não podem usar esta diretiva.

Observação

Você pode usar a ferramenta Reg2inf para converter diretivas INF RegisterDlls existentes em diretivas INF AddReg para tornar um pacote de driver 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 autoregistro.

[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.

Inscrições

Dirid
Especifica o 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.

nome do arquivo
Identifica o nome do arquivo do controle OLE a ser registrado.

bandeiras de registo
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).

tempo de espera
Especifica o tempo limite, em unidades de segundos, para um controle OLE concluir as chamadas de registro especificadas. O tempo limite padrão é de 60 segundos.

argumento
Se o controle for um arquivo executável, essa é 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 especifica o argumento de linha de comando a ser passado para a função DllInstall .

Observações

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 seguintes regras se aplicam ao uso da diretiva RegisterDlls para instalações de dispositivos:

  • Embora a sintaxe permita que o nome do arquivo seja uma DLL ou um arquivo executável, para instalações de dispositivos apenas uma DLL é permitida.

  • O código a ser registrado não deve solicitar a entrada do usuário.

  • As instalações do lado do servidor são executadas em um contexto de sistema. Portanto, você deve ter certeza de que o código que está sendo registrado não contém vulnerabilidades 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

Ver também

UnregisterDlls