1.2.204 SXCopyFiles – Dateien kopieren
SXCopyFiles (strMsg,strSrcSubDir,strFileSpec,strTargetDir,nPercentFrom,nPercentTo,nMode);
|
Argumente
|
strMsg
Text während des Kopiervorganges
| ||||||||
|
|
strSrcSubDir
Quellverzeichnis der zu kopierenden Dateien
| ||||||||
|
|
strFileSpec
wildcardfähige Spezifikation der Quelldateien
| ||||||||
|
|
strTargetDir
Verzeichnis in das die Dateien kopiert werden sollen
| ||||||||
|
|
strTargetSpec
Nicht wildcardfähige Spezifikation des Zieldateinamens. strSrcSpec darf keine wildcards enthalten
| ||||||||
|
|
nPercentFrom
Anzeige des Statusbarwert bei Beginn der Kopieraktion
| ||||||||
|
|
nPercentTo
Anzeige des Statusbarwert nach Abschluss der Kopieraktion
| ||||||||
|
|
nMode
LockedFiles
Veranlasst SXCopyFile gesperrte .dll und .exe Dateien für eine Aktualisierung zu protokollieren, wenn Windows oder das System erneut gestartet werden. Eine gesperrte Datei ist eine Date, die von einer Anwendung oder dem System benutzt wird, wenn InstallShield versucht, auf diese Datei zuzugreifen oder sie zu aktualisieren. Die Option LockedFiles funktioniert wie SHAREDFILE, außer dass LockedFiles keine Registry-Einträge macht oder den Registry Reference Zähler modifiziert. Man kann die Option LockedFiles nicht benutzen, wenn die SHAREDFILE Option benutzt wird. Es gibt Dateien, die unshared sind, (wie die Oberflächenerweiterung), für die der Skriptschreiber keinen Registry-Eintrag und keinen Referenzzähler wünscht. Diese Dateien sollten nie deinstalliert werden, außer von der Anwendung selber. LockedFiles ermöglicht SXCopyFile den Umgang mit gesperrten Dateien, die nicht gemeinsam benutzt werden.
Subdirs
Legt fest, dass Unterverzeichnisse unter dem Quellpfad ebenfalls kopiert werden müssen.
| ||||||||
|
Rückgabewert
|
COPY_ERR_CREATEDIR: -6193
Gibt an, dass ein Zielverzeichnis nicht angelegt werden konnte. Vergewissern Sie sich, dass der Pfad in der Systemvariablen str$TARGETDIR syntaktisch korrekt ist und Sie Zugriffsberechtigung auf das Zielverzeichnis haben.
COPY_ERR_MEMORY: -6198
Zeigt an, dass es nicht möglich war, den für den vollständigen Kopiervorgang benötigten Speicher zuzuteilen. Beenden Sie so viele laufende Anwendungen wie möglich, um Speicher frei zu machen.
COPY_ERR_NODISKSPACE: -6194
Zeigt an, dass nicht genug Speicher auf dem Ziellaufwerk vorhanden ist, um die Dateien zu kopieren. Machen Sie Speicher im Ziellaufwerk frei.
COPY_ERR_OPENINPUT: -6195
Zeigt an, dass es nicht möglich war, die Input-Datei in der Systemvariablen SRCDIR zu öffnen. Vergewissern Sie sich, dass die Quelldatei ein gültiger Dateiname ist, und dass sowohl die Quelldatei als auch das Zielverzeichnis existieren.
COPY_ERR_OPENOUTPUT: -6196
Zeigt an, dass es nicht möglich war, die gewünschte Datei zu kopieren.
COPY_ERR_TARGETREADONLY: -6197
Zeigt an, dass die Datei in TARGETDIR Nur-Lese-Status hat. Entfernen Sie das Nur-Lese-Attribut von der Zieldatei, und versuchen Sie es erneut.
-51 Eine selbstregistrierende Datei hat sich nicht richtig registriert.
| ||||||||
|
Beschreibung
|
Funktion SXCopyFile kopiert eine oder mehrere Dateien vom Quellverzeichnis in das Zielverzeichnis. Diese Funktion kopiert sowohl Unterverzeichnisse als auch Dateien. Dateien können über wildcards eingeschränkt werden (z.B. "*.DLL").
XCopyFile kann Unterverzeichnisse im Zielverzeichnis anlegen, falls in nMode die entsprechene Konstante übergeben wird.
Man kann mit XCopyFile Dateien nicht umbenennen. Soll eine Datei während einer Kopierfunktion umbenannt werden, benutzen Sie die Funktion SCopyFile.
| ||||||||
|
Funktionsart
|
infraSetupFunktion
| ||||||||
|
siehe auch
|
SCopyFiles
|