TRegSvr.exe, l'outil de recensement des bibliothèques de types

De RAD Studio
Aller à : navigation, rechercher

Remonter à Utilitaires de ligne de commande - Index


TRegSvr.exe est un outil permettant de recenser et de dérecenser les bibliothèques de types et les serveurs COM/ActiveX. TRegSvr.exe vous permet de recenser seulement une bibliothèque de types. C'est très pratique dans les cas où vous voulez effectuer le marshalling d'une bibliothèque de types, mais ne souhaitez pas nécessairement recenser l'objet avec COM. L'utilisation de TRegSvr.exe pour recenser seulement une bibliothèque de types pour l'utilisateur en cours peut permettre le marshalling COM, même pour un utilisateur sans droits Administrateur. TRegSvr.exe est livré avec Delphi et est situé dans le répertoire /bin de l'installation du produit.

Vous pouvez utiliser TRegSvr comme alternative aux actions de recensement/dérecensement (décrites dans Recensement d'un objet COM) :

  • Commande Recenser (Exécuter > Serveur ActiveX > Recenser)
  • Commande Recenser pour l'utilisateur en cours (Exécuter > Serveur ActiveX > Recenser pour l'utilisateur en cours)
  • Commande Dérecenser (Exécuter > Serveur ActiveX > Dérecenser)
  • Commande Regsvr32 (documentée dans l'aide d'accompagnement du SDK Microsoft Windows)

Remarque : L'EDI, étant un processus 32 bits, ne peut pas recenser les serveurs DLL/en processus 64 bits (les processus 32 bits ne peuvent pas charger les DLLs 64 bits). Pour recenser les serveurs en processus 64 bits, vous devez utiliser la version 64 bits de TRegSvr.exe, située dans $(BDS)\bin64\TRegSvr.exe.

Syntaxe de la ligne de commande

>tregsvr <options> <filename>


  • -u (dérecenser)
  • -q (recensement silencieux - pas de sortie)
  • -c (recensement / dérecensement pour l'utilisateur en cours)
  • -t (recensement d'une bibliothèque de types)
  • -s (recensement côte à côte sans un chemin complet, pour le recensement d'un serveur dont le client / consommateur résidera dans le même répertoire que le serveur)

Filename représente le nom de la bibliothèque de types.

Aide de la ligne de commande

Filename représente le nom de la bibliothèque de types.

>tregsvr

L'aide suivante est affichée par TRegSvr.exe :

Embarcadero Turbo Register Server -- COM Server Registration utility.
Version 1.3  Copyright (c) 1997-2010 Embarcadero Technologies, Inc.

Syntax: TREGSVR [options] filename
 -u  =  Unregister server or type library
 -q  =  Quiet (silent) operation
 -c  =  Register or unregister for current user
 -t  =  Register type library (default for .TLB files)
 -s  =  "Side By Side" type library registration (do not use full path)

Exemples de ligne de commande

La commande suivante recense 'server.ocx' pour tous les utilisateurs :

   > tregsvr.exe  c:\dev\myprojects\server.ocx

La commande suivante dérecense le serveur 'server.ocx' (c'est-à-dire, annule ce que la commande précédente avait fait) :

   > tregsvr.exe -u c:\dev\myprojects\server.ocx

La commande suivante recense la bibliothèque de types Midas pour l'utilisateur en cours :

   > tregsvr.exe -t -c midas.dll

Le source de l'application exemple tregsvr est installé avec les exemples de l'installation de votre produit. Vous pouvez aussi extraire une copie de l'exemple tregsvr (ou d'autres exemples) d'un référentiel Subversion public situé sur http://sourceforge.net/p/radstudiodemos/code/HEAD/tree/branches/RADStudio_Rio/Object%20Pascal/VCL/tregsvr.

   tregsvr -v [-c] ServerName

Le nom spécifié peut être partiel. Par exemple, la commande suivante affiche tous les serveurs contenant la chaîne 'msxml' :

  > tregsvr -v msxml

La commande ci-dessus génère la sortie suivante sur une installation Windows typique, et indique qu'un serveur correspondant a été trouvé :

Embarcadero Turbo Register Server -- COM Server Registration utility.
Version 1.3  Copyright (c) 1997-2010 Embarcadero Technologies, Inc.

Searching for typelibrary entries matching "msxml4" in HKLM
-------------------------------------------------------
(1)  : C:\Windows\system32\msxml4.dll
TLB  : {F5078F18-C551-11D3-89B9-0000F81FE221}
DESC : Microsoft XML, v4.0 (Version 4.0)
CLSID: {88D969C0-F192-11D4-A65F-0040963251E5}
CLSID: {88D969C1-F192-11D4-A65F-0040963251E5}
CLSID: {88D969C4-F192-11D4-A65F-0040963251E5}
CLSID: {88D969C5-F192-11D4-A65F-0040963251E5}
CLSID: {88D969C6-F192-11D4-A65F-0040963251E5}
PRGID: Msxml2.DOMDocument.4.0
PRGID: Msxml2.FreeThreadedDOMDocument.4.0
PRGID: Msxml2.DSOControl.4.0
PRGID: Msxml2.XMLHTTP.4.0
PRGID: Msxml2.ServerXMLHTTP.4.0
-------------------------------------------------------
Found 1 entries matching "msxml4" out of 561

Voir aussi

Exemples