Reg2inf

L’outil de conversion du registre INF du package de pilotes (reg2inf.exe) convertit une clé de Registre et ses valeurs ou un COM .dll implémentant une routine DllRegisterServer en un ensemble de directives INF AddReg ou section INF DDInstall.COM pour les serveurs COM en processus, pour l’inclusion dans un fichier INF du package de pilotes. Cet outil est particulièrement utile pour convertir les directives INF RegisterDlls existantes en directives ADDReg INF ou inf DDInstall.COM sections afin de rendre un fichier INF universel. Pour plus d’informations sur les fichiers INF universels, consultez Utilisation d’un fichier INF universel.

À compter de Windows 10 version 1709, l’outil est fourni dans le cadre de l’installation de WDK 10. Vous pouvez le trouver dans le \tools sous-répertoire de votre installation WDK 10, par exemple C:\Program Files(x86)\Windows Kits\10\tools\.

Bien que Reg2inf tente de générer une inscription COM, il peut ne pas capturer l’état de Registre complet fourni par l’inscription COM. Comme toujours, vous devez inspecter la sortie de l’outil pour vous assurer de leur exhaustivité et de leur exactitude, et tester les résultats.

Exécution de Reg2inf à partir de la ligne de commande

Cette section répertorie les options de ligne de commande pour Reg2inf.

reg2inf.exe [/downlevel]  [/key <path> | /dll <filename>] [/targetkey <path>]

• /downlevel

  Ignore DDInstall.COM style de syntaxe et imprime la sortie uniquement via les directives AddReg. Cette option doit être utilisée uniquement pour les sections INF qui ciblent les versions du système d’exploitation antérieures à Windows 11 version 24H2.

• /key <registry key path>

  Traiter une clé de Registre spécifique, par exemple : reg2inf /key HKEY_LOCAL_MACHINE\SOFTWARE\Fabrikam

• /dll <module filename>

  Traitez un module DLL COM qui implémente le point d’entrée DllRegisterServer, généralement appelé par regsvr32.exe ou une directive INF RegisterDlls héritée pour inscrire une classe COM sous HKEY_CLASSES_ROOT, par exemple : reg2inf /dll %SystemRoot%\System32\fabkobj.dll

• /targetkey <registry key path>

  Le remappage de la clé de Registre cible doit être effectué sous un autre chemin de clé de base, par exemple : reg2inf /key HKLM\SYSTEM\Temp /targetkey HKR\Parameters

Inscription d’un composant COM dans un fichier INF

L’extrait de code suivant montre comment inscrire une classe COM simple à l’aide de la syntaxe inf DDInstall.COM, comme produit par Reg2inf sans le /downlevel paramètre :

[SimpleCom.COM]
AddComServer = COM_Server,,SimpleCom_Install

[SimpleCom_Install]
ServerType = 1
ServerBinary = %13%\comobj.dll
AddComClass = Sample Class,{92FCF37F-F6C7-4F8A-AA09-1A14BA118084},,SimpleCom_Class_Install

[SimpleCom_Class_Install]
ThreadingModel = Both

L’extrait de code suivant montre comment inscrire une classe COM simple à l’aide de la syntaxe AddReg INF, comme produit par Reg2inf avec le /downlevel paramètre :

[ComClass_AddReg]
HKCR,CLSID\{92FCF37F-F6C7-4F8A-AA09-1A14BA118084},,,"Sample Class"
HKCR,CLSID\{92FCF37F-F6C7-4F8A-AA09-1A14BA118084}\InprocServer32,,%REG_EXPAND_SZ%,"%13%\comobj.dll"
HKCR,CLSID\{92FCF37F-F6C7-4F8A-AA09-1A14BA118084}\InprocServer32,ThreadingModel,,"Both"