InstallFiles művelet
Az InstallFiles művelet a Fájl táblában megadott fájlokat másolja a forráskönyvtárból a célkönyvtárba.
Sorozatkorlátozások
Az InstallFiles műveletnek az InstallValidate művelet után, valamint a fájlfüggő műveletek előtt kell érkeznie.
ActionData-üzenetek
| Mező | A műveleti adatok leírása |
|---|---|
| [1] | A telepített fájl azonosítója. |
| [6] | A telepített fájl mérete bájtban. |
| [9] | A telepített fájlt tartalmazó könyvtár azonosítója. |
Megjegyzések
Az InstallFiles művelet a Fájltábla. Minden fájl telepítése a fájl társított összetevőjének telepítési állapota alapján történik a Összetevő tábla. Másolásra csak azok a fájlok jogosultak, amelyek összetevői az msiInstallStatelocal állapotra vannak feloldva.
Az InstallFiles művelet a Fájltábla alábbi oszlopait valósítja meg.
- A Fájlnév oszlop a célfájl nevét adja meg.
- A Verzió oszlop a fájlverziót adja meg.
- Az Attribútumok oszlop a fájl- és telepítési attribútumjelölő biteket határozza meg.
- A Fájl oszlop az egyedi fájljogkivonatot adja meg.
- A FileSize oszlop bájtban adja meg a tömörítetlen fájlméretet.
- A Nyelv oszlop a fájlnyelv-azonosítót adja meg.
- A Szekvencia oszlop az adathordozón lévő sorszámot adja meg.
Az InstallFiles művelet a Komponens tábla alábbi oszlopait valósítja meg.
- A Directory_ oszlop egy Címtártábla elemre mutató hivatkozást ad meg.
- Az Összetevő oszlop az összetevőelem egyedi nevét adja meg.
A megadott fájl csak akkor lesz másolva, ha az alábbiak egyike igaz:
- A fájl jelenleg nincs telepítve a helyi számítógépen.
- A fájl a helyi számítógépen található, de alacsonyabb verziószámmal rendelkezik, mint a Fájltábla.
- A fájl a helyi számítógépen található, de nincs társított verziószám.
A másolandó fájlok forráskönyvtárát a sourceMode határozza meg, amely viszont a Media tábla Kabinet oszlopában lévő értéktől függ. A forrás mód teljes körű ismertetését a Média táblacímű témakörben talál.
Ha a másolandó fájl forráskönyvtára cserélhető adathordozón , például hajlékonylemezen vagy CD-ROM-on található, az InstallFiles művelet ellenőrzi, hogy a megfelelő forrás adathordozó be van-e szúrva a fájl másolása előtt. Az InstallFiles azonos cserélhető típusú adathordozót keres egy kötet címkével, amely megfelel a Media tábla VolumeLabel oszlopában megadott értéknek. Ha talál egy megfelelő csatlakoztatott kötetet, a fájlmásolási folyamat folytatódik. Ha nem található egyezés, egy párbeszédpanel kéri, hogy a felhasználó szúrja be a megfelelő adathordozót. Ebben az esetben a párbeszédpanel a Média tábla DiskPrompt oszlopában található médianevet használja a parancssor részeként.
Körültekintően kell eljárni, mert az InstallFiles művelet törölheti az eredeti fájlt, és nem cserélheti le. Ez akkor fordul elő, ha az InstallFiles művelet hibát tapasztal egy régebbi fájl cseréjekor, és a felhasználó úgy dönt, hogy figyelmen kívül hagyja a hibát. A telepítő alapértelmezett viselkedése egy régi fájl törlése az új fájl helyes másolásának biztosítása előtt.
A telepítő által használt fájlverziós szabályokért lásd fájlverziós szabályok.