Diretiva INF UnregisterDlls

Cuidado

A partir Windows 11 versão 22H2, um pacote de driver que usa essa diretiva não está mais qualificado para uma assinatura do Centro de Desenvolvedores de 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 auto-registro (autoextração).

[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 seção unregister-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 cancelado. Para obter mais informações, consulte Usando Dirids.

Subdir
Especifica o caminho do diretório, em relação ao diretório atual, para o arquivo a ser cancelado. Se não for especificado, o arquivo estará no diretório atual.

filename
Identifica o nome do arquivo do controle OLE a ser cancelado.

sinalizadores de registro
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 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 será 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 seção unregister-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.

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

Confira também

RegisterDlls