Compartilhar via


Diretiva INF UnregisterDlls

Cuidado

A partir do Windows 11 versão 22H2, um pacote de driver que usa essa diretiva não está mais qualificado para uma assinatura da Central do Desenvolvedor para Hardware.

Os pacotes de driver Universais e os Drivers do Windows não podem usar essa diretiva.

Uma diretiva UnregisterDlls faz referência a uma ou mais seções INF usadas para especificar arquivos que são controles OLE e exigem o cancelamento automático do registro (remoção automática).

[DDInstall]
  
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...

Cada seção INF referenciada por uma diretiva UnregisterDlls deve ter o seguinte formato de entrada:

[unregister-dll-section] 
  
dirid,[subdir],filename,registration-flags[,[timeout][,argument]] 

Uma unregister-dll-section 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 ter o registro cancelado. Para obter mais informações, confira Como usar Dirids.

subdir
Especifica o caminho do diretório, relativo ao diretório atual, para o arquivo a ter o registro cancelado. Caso não seja especificado, o arquivo está no diretório atual.

filename
Identifica o nome do arquivo do controle OLE a ter o registro cancelado.

registration-flags
Indica as operações de registro a serem executadas no controle OLE. Deve-se especificar um ou ambos os sinalizadores a seguir.

0x00000001 (FLG_REGSVR_DLLREGISTER)
Chame a função DllUnRegisterServer (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 cancelamento de registro especificadas. O tempo limite padrão é de 60 segundos.

argument
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 é /UnRegServer.

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 unregister-dll-section deve ser exclusivo dentro do arquivo INF e deve seguir as regras gerais para definir nomes de seção. Para mais informações sobre essas regras, consulte Regras gerais de sintaxe para arquivos INF.

Para obter mais informações sobre controles OLE e cancelamento de registro automático, consulte a documentação do SDK do Windows.

Exemplos

[Dialer]
RegisterDlls = DialerRegSvr

[DialerUninstall]
UnregisterDlls = DialerRegSvr

[DialerRegSvr]
11,,avtapi.dll, 1

Confira também

RegisterDlls