PE Builder v3 Aide
Table des matières

Format de fichier Plugin


  1. Introduction
  2. Création d'un plugin
  3. Section PEBuilder
  4. Section WinntDirectories
  5. Section SourceDisksFiles
  6. Section SourceDisksFolders
  7. Logiciel. Section AddReg
  8. Logiciel. Section DelReg
  9. SetupReg. Section AddReg
  10. Défaut. Section AddReg
  11. Défaut. Section DelReg
  12. Section AddLine
  13. Section DelLine
  14. Section SetValue
  15. Ajoutez section
  16. Variables

Introduction

Ce document doit vous aider à créer ou modifier les plugins de PE Builder. Le fichier principal *.inf de PE Builder est pebuilder.inf. Veuillez ne pas modifier ce fichier! Si vous voulez apporter un changement quelconque, employez un fichier plugin. Tous les plugins sont placés dans le répertoire Plugins. Chaque fichier *.inf figurant dans le répertoire Plugins(dans n'importe quel dossier) avec une section "pebuilder" est considéré comme un plugin valable par PE Builder. L'utilisation du bouton Activer / Désactiver dans le dialogue plugin, permet d'activer ou non le plugin.

Création d'un plugin

Un fichier plugin *.inf doit être un fichier ascii, et non unicode. Les lignes commençant par un ";" (point-virgule) sont ignorées, ou employées pour un commentaire.

Chaque fichier plugin doit commencer par les lignes suivantes :

  
; PE Builder v3 module d'extension INF fichier
; créé par Bart Lagerweij
; http://www.nu2.nu/pebuilder/

;; Courte description de l'action du plugin...

[Version]
Signature="$Windows NT$"

[PEBuilder] 
Name="NomduPlugin" 
Enable=0 
Help="pluginAide.htm"
 
Veuillez noter que vous devez inclure l'information de [Version] Signature="$Windows NT$". Autrement, les fonctions de setupapi ne peuvent pas ouvrir le fichier .inf. Veuillez utiliser les informations ci-dessous pour ajouter d'autres sections à votre plugin...

Section PEBuilder

Si vous créez un plugin, votre fichier *.inf doit avoir une section [PEBUILDER]! Conservez les noms de rubriques en anglais.
Name Nom du plugin
Enable Etat du plugin
0 - Désactivé
1 - Activé
Help Le nom de fichier pour l'aide. Cela peut être un texte, *.HTML, *.doc, *.pdf ou un autre type de fichier. PE Builder emploie la fonction ShellExecute () pour commencer le document avec son association par défaut.
Config Le nom de fichier pour le fichier de configuration.

Section WinntDirectories

La section WinntDirectories est dans le format suivant :
DirectoryID=dirname [, attribute]

Où...
DirectoryID Est le numéro d'identification (ID) du répertoire
Dans des fichiers plugins *.inf, vous pouvez employer 'a'-'z' pour l'assignation dynamique d'un nombre...
Dirname C'est le nom du répertoire. Si le nom contient des espaces, mettez le entre guillemets "comme cela".
Attribute Valeur numérique pour activer / désactiver des options
Valeur :
1 - Créer toujours ce répertoire (même quand il est vide)
2 - Créer le répertoire de destination (Sortie) depuis la racine (avec l'indication \ et non \i386).
Ajouter juste les valeurs à combiner...
La valeur par défaut pour l'attribut est 0.

Exemple :
  
[WinntDirectories]
; Toujours créer un répertoire appelé "Bart" à la racine,  
a="Bart",3
; créer un répertoire nommé "Project\Bart\Source"à la racine,   
b="Project\Bart\Source",3; 
; créer un sous-répertoire appelé "extra\files" dans le répertoire i386,   
c="extra\files",1
 

Voici une liste des identifiants de répertoires (ID) les plus employés :
ID Répertoire Remarque
30000 [Racine] Racine de destination (Sortie) de PE Builder
1 \ SystemRoot (sur le CD, c'est le dossier \i386. Sur le disque dur, il s'agit du dossier \miniNT)
2 System32
3 System32\config
4 System32\drivers
5 System
17 System32\drivers\etc
20 Inf
21 Aide
22 Fontes
24 Msagent\intl
52 Msagent
124 WinSxS
125 WinSxS\Manifests
252 WinSxS\Policies

PE Builder emploie l'identifiant de répertoire commençant par 30000. L'ID 30000 est employée pour le répertoire racine de destination (Sortie). 30001 et les suivants sont dynamiquement employés par PE Builder.

Section SourceDisksFiles

SourceDisksFiles [.build]

Cette section est employée pour copier des fichiers. Si vous ajoutez un numéro de Produit de Windows après le nom de section, cette section emploiera seulement les médias source de ce Produit.

Produit Version
2600 Windows XP
3790 Serveur 2003

La section SourceDisksFiles emploie le format suivant :
Filename=directoryID [, filenameRenamed] [, attribute]

Où...
Filename Est le nom du fichier à copier.
DirectoryID Est le numéro d'identification du répertoire cible. Voir la section WinntDirectories pour une liste d'identifiants de répertoires standards de Windows.
FilenameRenamed Est le nom du fichier cible, si un changement de nom s'avère nécessaire.
Attribute Valeur numérique pour Activer / Désactiver des options
Valeur :
1 - Employé par pluginCheck (). Assurez-vous que le fichier existe dans le même répertoire que celui où le fichier .inf est placé, avant de continuer.
2 - Ne décompresse pas le fichier.
4 - Copie seulement le fichier s'il existe. Ne vous plaignez pas quand il n'existe pas!
8 - Rebaptise le nom de fichier en lettres majuscules. En construisant une image ISO, PE Builder réécrit les noms de fichiers de Windows en lettres majuscules (exigé pour le démarrage du CD).
La valeur par défaut pour l'attribut est 0.

Section SourceDisksFolders

SourceDisksFolders [.build]

Cette section est employée pour copier des répertoires complets et les sous-répertoires. La section SourceDisksFolders emploie le format suivant :
Sourcepath=directoryID

Où...
Sourcepath Est le chemin / répertoire source à partir duquel s'effectue la copie. C'est une copie exacte où rien n'est décompressé ou extrait!
DirectoryID Est le numéro d'identification du répertoire cible. Voir la section WinntDirectories pour une liste d'identifiants de répertoires standards de Windows.

Exemple :
  
[WinntDirectories] 
a="Programs\openoffice",2

[SourceDisksFolders]
; quand le répertoire openoffice est dans le répertoire plugin 
openoffice=a

[SourceDisksFolders]
; quand le répertoire openoffice est dans c:\ 
c:\openoffice=a  

Section Software.AddReg

Software.AddReg[.build]

Ajouter des clefs d'enregistrement à la ruche du registre de la partie Software HKEY_LOCAL_MACHINE\SOFTWARE.
Cette section est dans le format suivant :
RegType, regKey, regValue, regData

Où...
RegType Indique le type d'information à stocker, comme les données de la valeur. Ce paramètre peut être une des valeurs suivantes :
0x0, (REG_NONE) crée seulement la clé, pas de valeur
0x1, (REG_SZ) chaîne de caractères
0x2, (REG_EXPAND_SZ) chaîne (avec référence de variable d'environnement)
0x3, (REG_BINARY) données binaires
0x4, (REG_DWORD) nombre 32 bits
0x7, (REG_MULTI_SZ) chaînes multiples
* Noter : Doit commencer par "0x"(x en minuscule)!
RegKey Indique le nom de la clé comme une chaîne de caractères.
RegValue Spécifie le nom de la valeur comme une chaîne de caractères.
RegData La donnée réelle à placer dans la valeur.

Exemple :
  
0x1, "Microsoft\Windows NT\CurrentVersion\Fonts", "Tahoma (TrueType)", "TAHOMA.TTF" 
0x2, "Contrôle Panel\desktop", "Wallpaper", "systemroot %\system32\nu2.bmp" 
0x3, "ControlSet001\Control\TimeZoneInformation", "DaylightStart", \ 
       00,00,04,00,00,01,00,02,00,00,00,00,00,00,00,00 
0x4, "ControlSet001\Control\GraphicsDrivers\DCI", "Time Out", 0x7 
0x7, "ControlSet001\Services\VgaSave\Device0", "InstalledDisplayDrivers", "vga", "framebuf", "vga256", "vga64k" 

Section SetupReg.AddReg

SetupReg.AddReg[.build]

Ajouter des clés de registre à la ruche du registre "SetupReg.hiv". Même syntaxe que Software.AddReg

Section Default.AddReg

Default.AddReg [.build]

Ajouter des clés de registre à HKEY_CURRENT_USER, dans la partie Default du registre.
Même syntaxe que Software.AddReg

Section Software.DelReg

Software.DelReg[.build]

Supprimer des clefs d'enregistrement de la ruche du registre "Software". Cette section est dans le format suivant : regKey [, regValue]

Où...
RegKey Indique le nom de la clé (incluant toutes les valeurs) à supprimer, comme une chaîne de caractères.
RegValue Indique le nom de la valeur à supprimer, comme une chaîne de caractères.

Section Default.DelReg

Default.DelReg[.build]

Supprimer des clés d'enregistrement de la ruche du registre "Default". Même syntaxe queSoftware.DelReg

Section AddLine

AddLine[.build]

Ajouts de lignes à une section. Les lignes dans la section AddLine ont le format suivant :
Filename,Section,StringToAdd

Où...
Filename Est le nom de fichier où ajouter une ligne.
Section Est le nom de la section.
LineToAdd Est la ligne à ajouter.

Exemple :
"netmscli.inf", "MSClient. DelReg", "HKLM, Software\Microsoft\Rpc\SecurityService, 9"

Section DelLine

DelLine[.build]

Supprime des lignes du fichier. Les lignes dans la section DelLine ont le format suivant :
Filename,Section,StringToDel

Où...
Filename Est le nom de fichier où supprimer une ligne.
Section Est le nom de la section.
StringToDel Est la ligne à supprimer. Vous ne devez pas la désigner exactement, car n'importe quelle ligne commençant par "StringToDel" sera supprimée.

Exemple :
"netmscli.inf","MSClient.Browser.AddReg", "HKR, Parameters, MaintainServerList,"

Section SetValue

SetValue[.build]

Écrit la valeur du fichier. Les lignes dans la section SetValue ont le format suivant :
Filename,Section,Key,Value

Où...
Filename Est le nom de fichier où mettre une valeur.
Section Est le nom de section.
Key Est la clé pour lui assigner une valeur.
Value Est la donnée.

Exemple :
"netmscli.inf", "Alerter_Service_Inst", "StartType", "3"

Utiliser Filename,Section,Key pour enlever une clé
Utiliser Filename,Section pour enlever une section complète

Section Append

Append[.build]

Ajouter un fichier à un autre fichier. Les lignes dans la section Append ont le format suivant :
Filename,FilenameToAppend

Où...
Filename Est le fichier où les données seront ajoutées.
FilenameToAppend Est le fichier qui contient les données à ajouter.

Exemple :
Nu2menu.xml, penero_nu2menu.xml

Variables

La plupart des champs de chaînes de caractères dans le fichier plugin peuvent avoir quelques variables spéciales de PE-Builder:
Syntaxe : @variable

Où...
Variable S'applique à...
Program Le nom du compilateur (PE-Builder par défaut)
Version La version du compilateur
IsoFile Chemin absolu et nom de fichier d'image ISO
OutDir Chemin absolu du répertoire de destination (Sortie)
SourcePath Chemin absolu du répertoire Source
PluginDir Chemin absolu du répertoire de plugin courant
PluginFile Chemin absolu et nom de fichier du fichier de plugin actuel
Langue Langue actuelle
Verbose Mode commentaire (0 pour inactif, 1 pour actif)
Build Le numéro de Produit Windows (2600 pour XP, 3790 pour Serveur 2003)

Exemple :
[SourceDisksFiles]
Program.exe=2,,3
Lang\langue @.lng=2,,3

lang\langue @.lng s'applique à lang\french.lng (quand la langue française est choisie).

Table des matières

Droit d'auteur de PE Builder (c) 2002-2006 Bart Lagerweij. Tous droits réservés.