PE Builder v3 hjälp
Innehållsförteckning

"Plugin" filformat


  1. Introduktion
  2. Skapa en "plugin"
  3. PEBuilder
  4. WinNT katalogen
  5. Källfilerna
  6. Källkatalogen
  7. Mjukvarinställningar i registret "Software.AddReg"
  8. Mjukvaruinställningar i registret "Software.DelReg"
  9. Mjukvaruinställninar i registret "SetupReg.AddReg"
  10. Registerinställning i Default delen "Default.AddReg"
  11. Registerinställning i Mjukvarudelen"Software.DelReg"
  12. Lägg till rader
  13. Ta bort rad
  14. Sätt värde
  15. Tillägg
  16. Variabler

Introduktion

Dokumentets avsikt är att hjälpa er att skapa eller modifiera PE Builder:s "plugin" filer.
Huvudfilen är PE Builders fil pebuilder.inf. Editera inte denna fil!
Om du vill ändra något använd en "plugin" fil. Alla "plugins" är placerade i "plugin katalogen". Varje .inf fil i "plugin" katalogen (spelar ingen roll vilken katalog) med en "pebuilder" sektion anses som en giltig "plugins" för PE Builder. Använd dig av "Enable/Disable" knapparna i plugin fönstret för att sätta på eller stänga av "plugins".

Skapa "plugins"

En "plugin" .inf fil måste vara av typen ascii, inte unicode. Rader som börjar med ";",används för att kommentera.

Varje "plugin" fil ska börja enligt nedan:

; PE Builder v3 plug-in INF file
; Created by Bart Lagerweij
; http://www.nu2.nu/pebuilder/
;
; Kort beskrivning av vad "pluginet" gör.

[Version]
Signature= "$Windows NT$"

[PEBuilder]
Name="NiceNameOfPlugin"
Enable=0
Help="pluginhelp.htm"
Observera att du måste inkludera[Version] Signature= "$Windows NT$".
Annars kan inte setupapi funktionerna öppna .inf filen. Använd informationen nedan för att lägga till sektioner i dina "plugins"

PEBuilder

Om du skapar en "plugin" så måste din .inf fil innehålla en [PEBuilder] sektion!
Name"Pluginets" namn
EnableDet valda läget av "pluginet" av eller på
0 - Av
1 - På
HelpFilnamnet på hjälpfilen. Det kan vara en text, html, doc, pdf fil eller valfri filtyp.
PE Builder använder sig av ShellExecute() funktionen för att
starta dokumentationen med den förinställda associationen.
ConfigFilnamnet på konfigurationsfilen

WINNT katalogen.

Sektionen för WinNT katalogen är utformat enligt följande format:
directoryID=dirname[, attribute]

where...
directoryIDär katalogensnummer. (id)
I "pluginens" .inf fil kan du använda bokstäverna a-z för dynamisk numrering...
dirnameär namnet på katalogen. Om katalogen innehåller blanktecken så behöver man sätta "citationstecken" som omger katalognamnet.
attributeNumeriskt värde för att sätta på eller stänga av:
1 - Skapa alltid den här katalogen (även om den är tom).
2 - Skapa katalogen från (utdata) root (i \ och inte i \i386.
Lägg till värden för att kombinera...
Förinställda valet för attributet är 0.

Exempel:
[WinntDirectories]
; Skapa alltid en katalog i rooten som heter "Bart".
a="Bart",3
; Skapa en katalog i rooten som heter "Project\Bart\Source".
b="Project\Bart\Source",3
; Skapa en katalog i som heter "extra\files"
c="extra\files",1

Här är en lista över de vanligaste katalogernas ID:
IDDirectoryRemark
30000[root]PE Builder output root
1\Systemrooten (på cd är det \i386 katalogen, på hårddisken är det \minint katalogen
2system32
3system32\config
4system32\drivers
5system
17system32\drivers\etc
20inf
21Help
22Fonts
24msagent\intl
52msagent
124WinSxS
125WinSxS\Manifests
252WinSxS\Policies

PE Builder använder sig av ett katalog ID som startar på 30 000. Där ID:et 30 000 används som root för utdata katalogen. 30 001 och upp används dynamiskt av PE Builder.

Källfilerna

SourceDisksFiles[.build]

Den här sektionen används för att kopiera filer. Om du lägger till ett kompileringsnummer efter sektionsnamnet, så kommer den sektionen endast bli använd av källmedia om den är från kompileringen.

BuildVersion
2600Windows XP
3790Server 2003

Sektionen för källfilerna använder sig av följande format:
filename=directoryID[, filenameRenamed][, attribute]

där...
filenameFilen som kopieras.
directoryIDMålkatalogens ID nummer. Läs WinntDirectories för en lista över Windows standardkataloger och dess ID.
filenameRenamedär målfilensnamn om den behöver döpas om.
attributeNumeriskt värde för att sätta på eller stänga av tillval:
1 - Avänds av pluginCheck(). Se till att filen finns i samma katalog som .inf filen, innan du slår på detta tillval eller fortsätter.
2 - Komprimera inte filen.
4 - Kopiera filen om den finns. Om den inte finns så rapportera inte det..
8 - Döp om filnamnet till versaler vid kompilering av ISO speglingen. Det behövs för start från CD-skiva. Det förinställda värdet är 0.

Källkatalogen

SourceDisksFolders[.build]

Denna sektion används för att kopiera kompletta kataloger och filer. Källkatalogen använder sig av följande format:
sourcepath=directoryID

där...
sourcepathär källsökvägen/katalogen som kopieras. Det här är en exakt kopia, inget är komprimerat eller extraherat!
directoryIDär målkatalogens nummer. Läs WinNT katalogen sektionen där du återfinner en lista av Windows standardkataloger och dess ID.

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

[SourceDisksFolders]
; När openoffice "pluginet" är en plugin katalog.
openoffice=a

[SourceDisksFolders]
; När openoffice katalogen ligger på c:\
c:\openoffice=a

Registerinställningar i mjukvarudelen "Software.AddReg"

Software.AddReg[.build]

Att lägga till nycklar i registret vid HKEY_LOCAL_MACHINE\SOFTWARE.
Följande sektion använder sig av följande format:
regType, regKey, regValue, regData

Där...
regTypeSpecificerar vilken typ av information som ska lagras. Den här parametern kan vara en av följande värden:
0x0, (REG_NONE) Skapar nyckel, inget värde.
0x1, (REG_SZ) Sträng.
0x2, (REG_EXPAND_SZ) Sträng (med miljövariabel referenser).
0x3, (REG_BINARY) Binärt data
0x4, (REG_DWORD) 32-bit nummer
0x7, (REG_MULTI_SZ) Flera strängar.
* Observera: måste starta med"0x" (gemener)!
regKeySpecificerar namnet på nyckeln som en sträng.
regValueSpecificerar värdet på nyckeln som en sträng.
regDataData

Exempel:
0x1, "Microsoft\Windows NT\CurrentVersion\Fonts", "Tahoma (TrueType)","TAHOMA.TTF"
0x2, "Control 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", "Timeout", 0x7
0x7, "ControlSet001\Services\VgaSave\Device0", "InstalledDisplayDrivers","vga", "framebuf", "vga256", "vga64k"

Registerinställning i setupdelen "SetupReg.AddReg"

SetupReg.AddReg[.build]

Lägger till registernycklar till "SetupReg.hiv". Samma syntax som i Registerinställningar i mjukvarudelen "Software.AddReg"

Registerinställning i Default delen "Default.AddReg"

Default.AddReg[.build]

Lägger till nycklar i HKEY_CURRENT_USER.
Samma syntax som i Registerinställningar i mjukvarudlen "Software.AddReg"

Registerinställning i Mjukvarudelen'Software.DelReg'

Software.DelReg[.build]

Tar bort register nycklar från "Software". Sektionen använder sig av följande format: regKey[, regValue]

där...
regKey Specificierar namnet på nyckeln (inkluderar alla värden) som en sträng, som ska tas bort.
regValue Specificerar namnet som ett sträng på värdet som ska tas bort.

Registerinställning i Defaultdelen "Default.DelReg"

Default.DelReg[.build]

Tar bort register nycklar från "Default". Samma syntax som Software.DelReg

Lägg till rader sektionen

AddLine[.build]

Lägger till rader till en sektion har följande format:
Filename,Section,StringToAdd

där...
Filenameär filnamnet på filen som du önskar lägga till en rad.
Sectionär sektionsnamnet.
LineToAddär raden som önskas lägga till.

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

Ta bort rad sektionen.

DelLine[.build]

Tar bort rader från en fil. Raderna i "DelLine" sektionen har följande format:
Filename,Section,StringToDel

där...
Filenameär filnamnet på filen där en rad läggs till.
Sectionär sektionsnamnet.
StringToDelär raden som ska tas bort. Behöver inte stämma överens exakt. Alla rader som börjar med "StringToDel" kommer tas bort.

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

Sätt värde sektionen

SetValue[.build]

Skriver ett värde till en fil. Raderna i "SetValue" sektionen har följande format:
Filename,Section,Key,Value

där...
Filename är filnamnet på filen dit värdet kommer sättas.
Sectionär sektionsnamnet.
Keyär nyckelvärdet som tilldelas ett värde.
Valueär värdet.

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

Use Filename,Section,KeyTa bort en nyckel.
Use Filename,Section Ta bort en hel sektion.

Tillägg

Append[.build]

Lägger till en fil till en annan fil. (Append=lägga till). Raderna i "Append section" har följande format:
Filename,FilenameToAppend

där...
Filenameär filen som data kommer läggas till.
FilenameToAppendär filen som innehåller datat som kommer läggas till.

Exempel:
nu2menu.xml, penero_nu2menu.xml

Variabler

De flesta sträng fälten i "plugin"filerna kan ha PE Builders special variabler:
Syntax: @variabel@

where...
Variabelsätts till...
ProgramNamnet på "the builder" (PE-Builder förinställt)
VersionBuilder version
IsoFileFullsökväg och filnamnet av ISO speglingen.
OutDirFullsökväg för utdata katalogen.
SourcePathFullsökväg av källkatalogen.
PluginDirFullsökväg av den nuvarande "plugin" katalogen.
PluginFileFullsökväg och filnamnet till nuvarande "plugin"fil.
LanguageNuvarande språk
VerboseDetaljerat läge (0 avser av, 1 avser på)
Buildwindows kompileringsnummer (2600 är detsamma som XP, 3790 är detsamma som server 2003)

Exempel:
[SourceDisksFiles]
program.exe=2,,3
lang\@language@.lng=2,,3

Där lang\@language@.lng kommer expanderas till lang\swedish.lng(om nu det svenska språket var förvalt).

Innehållsförteckning

PE Builder Copyright (c) 2002-2006 Bart Lagerweij. All rights reserved.