Directive INF RegisterDlls

Article
02/07/2024

Attention

À compter de Windows 11 version 22H2, un package de pilotes utilisant cette directive n’est plus éligible à une signature du Centre de développement matériel.

Les packages de pilotes universels et les pilotes Windows ne peuvent pas utiliser cette directive.

Notes

Vous pouvez utiliser l’outil Reg2inf pour convertir des directives INF RegisterDlls existantes en directives INF AddReg afin de rendre un package de pilotes universel.

Une directive RegisterDlls fait référence à une ou plusieurs sections INF utilisées pour spécifier des fichiers qui sont des contrôles OLE et qui nécessitent une inscription automatique.

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

Chaque section INF référencée par une directive RegisterDlls doit avoir le format d’entrée suivant :

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

Une section register-dll-section peut avoir n’importe quel nombre d’entrées, chacune sur une ligne distincte.

Entrées

dirid
Spécifie l’ID du répertoire de destination du fichier à inscrire. Pour plus d’informations, consultez Utilisation de Dirids.

Sous-répertoire
Spécifie le chemin du répertoire, relatif au répertoire actif, au fichier à inscrire. S’il n’est pas spécifié, le fichier se trouve dans le répertoire actif.

filename
Identifie le nom du fichier du contrôle OLE à inscrire.

registration-flags
Indique les opérations d’inscription à effectuer sur le contrôle OLE. L’un ou les deux indicateurs suivants doivent être spécifiés.

0x00000001 (FLG_REGSVR_DLLREGISTER)
Appelez la fonction DllRegisterServer du contrôle OLE (décrite dans la documentation du Kit de développement logiciel (SDK) Windows.

0x00000002 (FLG_REGSVR_DLLINSTALL)
Appelez la fonction DllInstall du contrôle OLE (décrite dans la documentation du Kit de développement logiciel (SDK) Windows).

timeout
Spécifie le délai d’attente, en unités de secondes, pour qu’un contrôle OLE effectue les appels d’inscription spécifiés. Le délai d’attente par défaut est de 60 secondes.

argument
Si le contrôle est un fichier exécutable, il s’agit d’une chaîne de commande qui est passée à l’exécutable. L’argument par défaut est /RegServer.

Si le contrôle n’est pas un fichier exécutable, cela spécifie l’argument de ligne de commande à passer à la fonction DllInstall .

Remarques

Chaque nom register-dll-section doit être unique au fichier INF et doit suivre les règles générales de définition des noms de section. Pour plus d’informations sur ces règles, consultez Règles de syntaxe générales pour les fichiers INF.

Les règles suivantes s’appliquent à l’utilisation de la directive RegisterDlls pour les installations d’appareils :

Bien que la syntaxe autorise le nom de fichier à être une DLL ou un fichier exécutable, pour les installations d’appareil, seule une DLL est autorisée.
Le code à inscrire ne doit pas inviter l’utilisateur à entrer.
Les installations côté serveur s’exécutent dans un contexte système. Par conséquent, vous devez être très sûr que le code inscrit ne contient aucune faille de sécurité et que les autorisations de fichier empêchent le code d’être modifié de manière malveillante.

Pour plus d’informations sur les contrôles OLE et l’auto-inscription, consultez la documentation du Kit de développement logiciel (SDK) Windows.

Exemples

[Dialer]
RegisterDlls = DialerRegSvr

[DialerUninstall]
UnregisterDlls = DialerRegSvr

[DialerRegSvr]
11,,avtapi.dll, 1

Voir aussi

DésinscrireDlls

Share via