Condividi tramite

Direttiva INF RegisterDlls

Attenzione

A partire da Windows 11 versione 22H2, un pacchetto driver che usa questa direttiva non è più idoneo per una firma da Hardware Developer Center.

I pacchetti driver universali e i driver di Windows non possono usare questa direttiva.

Nota

È possibile utilizzare lo strumento Reg2inf per convertire le direttive INF RegisterDlls esistenti in direttive INF AddReg per rendere universale un pacchetto driver.

Una direttiva RegisterDlls fa riferimento a una o più sezioni INF utilizzate per specificare i file che sono controlli OLE e richiedono la registrazione automatica.

[DDInstall]
  
RegisterDlls=register-dll-section[,register-dll-section]...

Ogni sezione INF a cui fa riferimento una direttiva RegisterDlls deve avere il formato di voce seguente:

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

Una sezione register-dll-può avere un numero qualsiasi di voci, ognuna in una riga separata.

whse.

dirid
Specifica l'ID della directory di destinazione del file da registrare. Per altre informazioni, vedere Uso di Dirids.

sottodir
Specifica il percorso della directory, relativo alla directory corrente, al file da registrare. Se non specificato, il file si trova nella directory corrente.

filename
Identifica il nome file del controllo OLE da registrare.

flag di registrazione
Indica le operazioni di registrazione da eseguire sul controllo OLE. È necessario specificare uno o entrambi i flag seguenti.

0x00000001 (FLG_REGSVR_DLLREGISTER)
Chiamare la funzione DllRegisterServer del controllo OLE (descritta nella documentazione di Windows SDK).

0x00000002 (FLG_REGSVR_DLLINSTALL)
Chiamare la funzione DllInstall del controllo OLE (descritta nella documentazione di Windows SDK).

timeout
Specifica il timeout, espresso in unità di secondi, affinché un controllo OLE completi le chiamate di registrazione specificate. Il timeout predefinito è 60 secondi.

argument
Se il controllo è un file eseguibile, si tratta di una stringa di comando passata al file eseguibile. L'argomento predefinito è /RegServer.

Se il controllo non è un file eseguibile, specifica l'argomento della riga di comando da passare alla funzione DllInstall .

Osservazioni:

Ogni nome register-dll-section deve essere univoco per il file INF e deve seguire le regole generali per definire i nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.

Le regole seguenti si applicano all'uso della direttiva RegisterDlls per le installazioni di dispositivi:

  • Sebbene la sintassi consenta il nome file come DLL o un file eseguibile, per le installazioni dei dispositivi è consentita solo una DLL.

  • Il codice da registrare non deve richiedere l'input dell'utente.

  • Le installazioni lato server sono eseguite in un contesto di sistema. Pertanto, è necessario essere molto sicuri che il codice registrato non contenga vulnerabilità di sicurezza e che le autorizzazioni di file impediscono che il codice venga modificato in modo dannoso.

Per altre informazioni sui controlli OLE e sulla registrazione automatica, vedere la documentazione di Windows SDK.

Esempi

[Dialer]
RegisterDlls = DialerRegSvr

[DialerUninstall]
UnregisterDlls = DialerRegSvr

[DialerRegSvr]
11,,avtapi.dll, 1

Vedi anche

Annulla registrazioneDlls