Directive INF RegisterDlls
Attention
À partir de la version 22H2 de Windows 11, un package de pilotes utilisant cette directive n’est plus éligible à une signature du Hardware Developer Center.
Les packages de pilotes universels et les pilotes Windows ne peuvent pas utiliser cette directive.
Remarque
Vous pouvez utiliser l’outil Reg2inf pour convertir les directives INF RegisterDlls existantes en directives INF AddReg afin de rendre un package de pilote 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 auto-inscription.
[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 peut avoir un nombre quelconque d’entrées, chacune sur une ligne distincte.
Entries
dirid
Spécifie l’ID du répertoire de destination du fichier à enregistrer. Pour plus d’informations, veuillez consulter la section Utilisation des Dirids.
subdir
Spécifie le chemin du répertoire, relatif au répertoire actuel, vers le fichier à enregistrer. Si non spécifié, le fichier se trouve dans le répertoire actuel.
nom_fichier
Identifie le nom de fichier du contrôle OLE à enregistrer.
registration-flags
Indique les opérations d’enregistrement à effectuer sur le contrôle OLE. Un ou les deux des indicateurs suivants doivent être spécifiés.
0x00000001 (FLG_REGSVR_DLLREGISTER)
Appelle la fonction DllRegisterServer du contrôle OLE (décrite dans la documentation du SDK Windows).
0x00000002 (FLG_REGSVR_DLLINSTALL)
Appelle la fonction DllInstall du contrôle OLE (décrite dans la documentation du SDK Windows).
timeout
Spécifie le délai d’attente, en unités de secondes, pour qu’un contrôle OLE termine les appels d’enregistrement 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 transmise à 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.
Notes
Chaque nom de section register-dll doit être unique au fichier INF et doit respecter les règles générales de définition des noms de section. Pour plus d'informations sur ces règles, voir Règles générales de syntaxe pour les fichiers INF.
Les règles suivantes s’appliquent à l’utilisation de la directive RegisterDlls pour les installations de périphériques :
Bien que la syntaxe permette que le nom de fichier soit soit un fichier DLL ou un exécutable, pour les installations de périphériques, seul un fichier DLL est autorisé.
Le code à enregistrer ne doit pas demander d’entrée utilisateur.
Les installations côté serveur s’exécutent dans un contexte système. Par conséquent, vous devez être absolument certain que le code à enregistrer ne contient aucune vulnérabilité de sécurité et que les autorisations des fichiers empêchent toute modification malveillante du code.
Pour plus d’informations sur les contrôles OLE et l’auto-inscription, consultez la documentation du SDK Windows.
Exemples
[Dialer]
RegisterDlls = DialerRegSvr
[DialerUninstall]
UnregisterDlls = DialerRegSvr
[DialerRegSvr]
11,,avtapi.dll, 1