PE Builder v3 help
Tartalom

Bővítmény fájl formátum


  1. Bevezető
  2. Bővítmény létrehozása
  3. PEBuilder bekezdés
  4. WinntDirectories bekezdés
  5. SourceDisksFiles bekezdés
  6. SourceDisksFolders bekezdés
  7. Software.AddReg bekezdés
  8. Software.DelReg bekezdés
  9. SetupReg.AddReg bekezdés
  10. Default.AddReg bekezdés
  11. Default.DelReg bekezdés
  12. AddLine bekezdés
  13. DelLine bekezdés
  14. SetValue bekezdés
  15. Append bekezdés
  16. Változók

Bevezető

Ez a dokumentum PE Builder bővítmények készítésében vagy létrehozásában segít. A PE Builder fő .inf fájl-ja a pebuilder.inf fájl. Kérem, ne módosítsa ezt a fájlt! Ha szeretne valamit megváltoztatni, használjon bővítmény fájlt. Minden bővítmény a plugin könyvtárban található. Minden .inf fájl a plugin könyvtárban (függetlenül attól, melyik alkönyvtárában található) melyben "pebuilder" bekezdés található, a PE Builder érvényes bővítményének minősül. Használja a Be/Ki gombor a bővítmény párbeszédablakban az egyes bővítmények ki/be kapcsolásához.

Bővítmény létrehozása

Egy bővítmény .inf fájlja ascii szöveges dokumentum, nem unicode. A pontosvesszővel ";" kezdődő sorokat figyelmen kívül hagyja (megjegyzések írására használható).

Minden bővítmény fájl a következő sorokkal kezdődjön:

; PE Builder v3 plug-in INF file
; Created by Bart Lagerweij
; http://www.nu2.nu/pebuilder/
;
; Rövid leírás arról, mi a bővítmény funkciója...

[Version]
Signature= "$Windows NT$"

[PEBuilder]
Name="BővítményBeceneve"
Enable=0
Help="pluginhelp.htm"
Felhívjuk figyelmét, hogy bele kell foglalni a [Version] Signature= "$Windows NT$" információt. Különben a setupapi függvények nem tudják megnyiltni az .inf fájlt. Használja a lenti információkat, hogy a bővítményekhez több bekezdést adjon...

PEBuilder bekezdés

Ha saját bővítményt készít, az .inf fájlnak tartalmaznia kell egy [PEBuilder] bekezdést!
Namea bővítmény neve
Enablea bővítmény bekapcsolt állapota
0 - Kikapcsolva
1 - Bekapcsolva
Helpa bővítmény súgójának fájl-neve. Ez lehet szöveg, html, doc, pdf vagy egyéb más fájl típus. A PE Builder a ShellExecute() függvényt használja hogy a dokumentumot a saját társított programjával megnyissa.
Configa beállító fájl neve.

WinntDirectories bekezdés

A WinntDirectories a következő formátumú:
könyvtárazonosító=könyvtárnév[, attribútum]

ahol...
könyvtárazonosítóa könyvtár száma (azonosítója)
A bővítmény .inf fájlban használhatók 'a'-'z' dinamikus szám hozzárendelések...
könyvtárnéva könyvtár neve. Ha szóközöket is tartalmaz, tegye "dupla idézőjelbe."
attribútumszámérték bizonyos opciók ki/bekapcsolására.
value:
1 - Mindíg hozza létre ezt a könyvtárat (akkor is, ha üres)
2 - Hozza létre a könyvtárat a (kimenet) gyökerében (a \ helyen, nem a \i386 helyen).
Ha mindkét dolgot szeretné, csak adja össze az értékeket...
Az attribútum alapértelmezett értéke 0.

Példa:
[WinntDirectories]
; Mindíg hozzon létre a gyökérkönyvtárban egy "Bart" nevű alkönyvtárat
a="Bart",3
; Hozzon létre a gyökérben egy "Project\Bart\Source" nevű alkönyvtárat
b="Project\Bart\Source",3
; Hozzon létre egy "extra\files" nevű alkönyvtárat az i386 könyvtárban
c="extra\files",1

Itt egy lista a (leggyakrabban használt) könyvtárak azonosítóiról:
azonosítóKönyvtárMegjegyzés
30000[root]PE Builder kimenet gyökere
1\SystemRoot (a CD-n ez a \i386 könyvtár, a merevlemezen a \minint könyvtár)
2system32
3system32\config
4system32\drivers
5system
17system32\drivers\etc
20inf
21Help
22Fonts
24msagent\intl
52msagent
124WinSxS
125WinSxS\Manifests
252WinSxS\Policies

A PE Builder 30000-től kezdődő könyvtár azonosítókat használ. A 30000-es azonosító a kimenet gyökér könyvtára. 30001 és attól fölfelé azonosítókat a PE Builder dinamikusan használja.

SourceDisksFiles bekezdés

SourceDisksFiles[.build]

Ez a bekezdés fájlok másolására szolgál. Ha build számot is megad a bekezdés név után, akkor az a bekezdést csak abban az esetben használja, ha a forrás média abból a build-ből származik.

BuildVerzió
2600Windows XP
3790Server 2003

A SourceDisksFiles bekezdés formátuma a következő:
fájlnév=könyvtárazonosító[, átnevezettfájlnév][, attribútum]

ahol...
fájlnéva másolandó fájl neve.
könyvtárazonosítóa cél könyvtár azonosító száma. Lásd a WinntDirectories bekezdést a szabványos windows könyvtárak azonosítójának listájához.
átnevezettfájlnéva cél fájl neve, amennyiben átnevezés szükséges.
attribútumbizonyos opciók ki/bekapcsolására használt numerikus érték
érték:
1 - a pluginCheck() használja. Győződjön meg róla, hogy a fájl létezik ugyanabban a könyvtárban, ahol az .inf fájl található, a folytatáshoz vagy a bővítmény bekapcsolásához.
2 - ne csomagolja ki a fájlt.
4 - csak akkor másolja a fájlt, ha létezik. Ne jelezze ha nem létezik.
8 - nevezze át a fájlnevet nagybetűsre. ISO kép készítésekor a PE Builder átnevezi a windows fájlneveket nagybetűsre (a CD-ROM-ról való induláshoz szükséges).
Az attribútum alapértelmezett értéke 0.

SourceDisksFolders bekezdés

SourceDisksFolders[.build]

Ez a bekezdés teljes könyvtárak és fájlok hozzáadására szolgál. A SourceDisksFolders bekezdés formátuma a következő:
forráskönyvtár=könyvtárazonosító

ahol...
forráskönyvtára forrás elérési útja, ahonnan a másolás történik. Ez egy pontos másolat, semmi sem csomagolódik ki!
könyvtárazonosítóa cél könyvtár azonosító száma. Lásd a WinntDirectories bekezdést a szabványos windows könyvtárak azonosítójának listájához.

Példa:
[WinntDirectories]
a="Programs\openoffice",2

[SourceDisksFolders]
; amikor az openoffice könyvtár a plugin könyvtár alatt található
openoffice=a

[SourceDisksFolders]
; amikor az openoffice könyvtár helye a c:\
c:\openoffice=a

Software.AddReg bekezdés

Software.AddReg[.build]

Rendszerleíró kulcsokat ad a HKEY_LOCAL_MACHINE\SOFTWARE helyhez.
A bekezdés formátuma a következő:
regTípus, regKulcs, regÉrték, regAdat

ahol...
regTípusmeghatározza az érték által tárolt információ típusát. Ez a paraméter a következők egyike lehet:
0x0, (REG_NONE) csak kulcsot hozzon létre, érték nélkül
0x1, (REG_SZ) szöveg
0x2, (REG_EXPAND_SZ) szöveg (környezeti változó hivatkozásokkal)
0x3, (REG_BINARY) bináris adat
0x4, (REG_DWORD) 32-bites szám
0x7, (REG_MULTI_SZ) többszörös szöveg
* Megjegyzés: a regTípus "0x" -val kell kezdődön (kisbetűs)!
regKulcsa kulcs nevét meghatározó szöveg.
regÉrtékaz érték nevét meghatározó szöveg.
regAdataz aktuális adat.

Example:
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"

SetupReg.AddReg bekezdés

SetupReg.AddReg[.build]

Rendszerleíró kulcsokat ad a "SetupReg.hiv" rendszerleíró struktúrához. A szintaxisa ugyanaz, mint a Software.AddReg-nek.

Default.AddReg bekezdés

Default.AddReg[.build]

Rendszerleíró kulcsokat ad a HKEY_CURRENT_USER -hez.
A szintaxisa ugyanaz, mint a Software.AddReg-nek.

Software.DelReg bekezdés

Software.DelReg[.build]

Rendszerleíró kulcsokat töröl a "Software" rendszerleíró struktúrából. A bekezdés formátuma a következő: regKulcs[, regÉrték]

ahol...
regKulcshatározza meg a kucs nevét (minden értékkel együtt) szövegesen, amit törölni kell.
regÉrtékhatározza meg a törlenő érték nevét szövegesen, amit törölni kell.

Default.DelReg bekezdés

Default.DelReg[.build]

Rendszerleíró kulcsokat töröl a "Default" rendszerleíró struktúrából. A szintaxisa ugyanaz, mint a Software.DelReg-nek.

AddLine bekezdés

AddLine[.build]

Sorok hozzáadása egy bekezdéshez. Az AddLine bekezdés sorainak formátuma a következő:
Fájlnév,bekezdés,hozzáAdottSzöveg

ahol...
Fájlnéva fájl neve, amihez a sor hozzáírandó.
bekezdésa bekezdés neve.
hozzáAdottSzövega sor, amit hozzá kell adni.

Példa:
"netmscli.inf", "MSClient.DelReg", "HKLM, Software\Microsoft\Rpc\SecurityService, 9"

DelLine bekezdés

DelLine[.build]

Sorokat töröl egy fájlból. A DelLine bekezdés sorainak formátuma a következő:
Fájlnév,bekezdés,törlendőSzöveg

ahol...
Fájlnéva fájl neve, amiből a sor törlendő.
bekezdésa bekezdés neve.
törlendőSzövega sor, ami törlendő. Nincs szükség pontos egyezésre, minden sor ami a "törlendőSzöveg"-gel kezdődik, törlődik.

Példa:
"netmscli.inf", "MSClient.Browser.AddReg", "HKR, Parameters, MaintainServerList,"

SetValue bekezdés

SetValue[.build]

Érték beírása egy fájlba. A SetValue bekezdés sorainak formátuma a következő:
Fájlnév,bekezdés,Kulcs,Érték

ahol...
Fájlnéva fájl neve, ahol az értéket be kell állítani.
bekezdésa bekezdés neve.
Kulcsa kulcs, amihez az értéket rendelni kell.
Értékaz adat.

Példa:
"netmscli.inf", "Alerter_Service_Inst", "StartType", "3"

Kulcs eltávolításához használha a Fájlnév,bekezdés,Kulcs-ot.
Teljes bekezdés eltávolításához használja a Fájlnév,bekezdés-t.

Append bekezdés

Append[.build]

Egy fájl hozzáfűzése egy másik fájlhoz. Az Append bekezdés sorainak formátuma a következő:
Fájlnév,HozzáfűzendőFájlnév

ahol...
Fájlnéva fájl neve, amihez az adat hozzáírandó.
HozzáfűzendőFájlnéva fájl, amiben a hozzáírandó adat található.

Példa:
nu2menu.xml, penero_nu2menu.xml

Változók

A legtöbb szöveg mező a bővítmény fájlban tartalmazhat speciális PE-Builder változókat:
Szintaxis: @variable@

ahol...
változóértéke...
Programa készítő program neve (alapértelmezésben PE-Builder)
Versiona készítő program verziója
IsoFileaz ISO kép teljes elérési útja és fájl neve
OutDira kimeneti könyvtár teljes elérési útja
SourcePatha bemeneti könyvtár teljes elérési útja
PluginDira jelenlegi bővítmény könyvtárának teljes elérési útja
PluginFilea jelenlegi bővítmény fájl teljes elérési útja és fájl neve
Languagejelenleg használt nyelv
Verbosebőbeszédű üzemmód (0 kikapcsolva, 1 bekapcsolva)
Builda windows build száma (a 2600 XP-t jelent, a 3790 pedig server 2003-at)

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

ahol lang\@language@.lng értéke lang\german.lng lesz (amennyiben a német nyelv van kiválasztva).

Tartalom

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