TransactFileToClient

betrifft

Die TransactFileToClient-Funktion erlaubt die Übertragung einer Datei vom Server zum Client.

 

Syntax

TransactFileToClient(SourceFile [, DestFile] [, AlwaysTransact] [, CreateDirectory])

Rückgabewert

Typ

Beschreibung

Long

0 wenn Funktion erfolgreich ausgeführt werden konnte

Parameter

Verwendung

Name

Typ

Übergabe

Beschreibung

Erforderlich

SourceFile

String

ByVal

Pfad zur Server-Datei, die zum Client transportiert werden soll. Wildcards sind nicht erlaubt. Vordefinierte Verzeichnisse werden unterstützt.

Optional

DestFile

String

ByVal

Pfad zur Datei beim Client. Siehe Anmerkung.

Optional

AlwaysTransact

Boolean

ByVal

Datei auch überschreiben, wenn bereits vorhanden

Optional

CreateDirectory

Boolean

ByVal

Verzeichnisse beim Client anlegen, falls erforderlich

 

Anmerkung

Der Dateipfad beim Client ist nur in absoluter Form (mit Laufwerksangabe) erlaubt.

Die Funktion unterstützt vordefinierte Verzeichnisse:

 

Begriff

Beschreibung

[TMPDIR]

Aktuelles Temp-Verzeichnis beim Client oder Server

Das Verzeichnis liegt häufig im Benutzer-Verzeichnis, z.B.

C:\Users\Benutzer.Domäne\AppData\Local\Temp

[APPDIR]

Das TCE-Programmverzeichnis beim Client oder Server, oftmals

C:\Program Files (x86)\TAP.CON\TCE

[WINDIR]

Das Windows-Verzeichnis beim Client oder Server, oftmals

C:\Windows

[SYSDIR]

Das Systemverzeichnis beim Client oder Server, oftmals

C:\Windows\System32

[APPDATADIR]

Das Anwendungsdatenverzeichnis beim Client oder Server, z.B.

C:\Users\Benutzer.Domäne\AppData\Roaming

[PROGDATADIR]

Das Programmdaten-Verzeichnis beim Client oder Server, z.B.

C:\ProgramData

 

Rückgabe der Funktion ist 0 bei Erfolg bzw. der Fehlercode der Übertragung.

 

Beispiel:

 

Server.TransactFileToClient("C:\DataForClients\setting.xml", "[APPDATADIR]\TCE\ settings.xml",, True)

Die serverseitige Datei C:\DataForClients\setting.xml wird zum Client in das Verzeichnis C:\Users\Benutzer.Domäne\AppData\Roaming\TCE\settings.xml kopiert. Sollte das Verzeichnis TCE nicht existieren, wird versucht, es anzulegen. Ist die serverseitige Datei nicht vorhanden, gibt die Funktion 53 zurück (Datei nicht vorhanden).