Directive INF UnregisterDlls

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.

Une directive UnregisterDlls 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-désinscription (auto-suppression).

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

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

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

Une section-unregister-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 à désinscrire. Pour plus d’informations, veuillez consulter la section Utilisation des Dirids.

subdir
Spécifie le chemin du répertoire, relatif au répertoire courant, vers le fichier à désinscrire. Si non spécifié, le fichier se trouve dans le répertoire actuel.

nom_fichier
Identifie le nom de fichier du contrôle OLE à désinscrire.

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 DllUnRegisterServer (décrite dans la documentation 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’expiration, en unités de secondes, pour qu’un contrôle OLE termine les appels de désinscription 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 /UnRegServer.

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 unregister-dll doit être unique pour le 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, voir Règles générales de syntaxe pour les fichiers INF.

Pour plus d’informations sur les contrôles OLE et l’auto-désinscription, veuillez consulter la documentation SDK Windows.

Exemples

[Dialer]
RegisterDlls = DialerRegSvr

[DialerUninstall]
UnregisterDlls = DialerRegSvr

[DialerRegSvr]
11,,avtapi.dll, 1

Voir aussi

RegisterDlls