AfArcTextRead

AfArcTextRead(alpha1, int2, int3[,alpha4]) : int
Textseite eines Archivs lesen
alpha1 Nummer des Archives int2 Nummer der Anhangdatei int3 Text-Deskriptor alpha4 temporärer Pfad (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfArcTextEdit()

Die Funktion liest den Archiv-Text einer Anhangdatei des Archivs (alpha1). Welche Anhangdatei gelesen werden soll, wird über den Parameter (int2) definiert.

Im dritten Parameter muss der Deskriptor eines leeren Text-Puffers übergeben werden, der vor dem Aufruf der Funktion über den Befehl AfTextOpen() angelegt wurde. Nach dem Aufruf der Funktion ist der Archiv-Text im Textpuffer abgelegt.

Der Archivtext wird von ArcFlow zwischenzeitlich in einem temporären Verzeichnis abgelegt und von dort von der API gelesen. Standardmäßig wird das im System eingestellte Temp-Verzeichnis verwendet. Über (alpha4) kann aber optional auch ein anderes Verzeichnis angegeben werden.

Der Benutzer muss in diesem Verzeichnis Schreibrechte besitzen.

Bei der Verwendung mit der Application Remote Control werden die Parameter mit folgenden Namen übergeben:

/ArcNr	Nummer des Archivs
/Page	zu lesende Anhangdatei
/Path	temporärer Pfad
/RsltPath	Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.

Zum Beispiel: /user=admin /password=troja /action=fnc /fnc=AfArctextRead /ArcNr=2008.0000012 /Page=1 /RsltPath=c:\temp\AFAPIRES.TXT

In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert. In der folgenden Zeile wird der Pfad und der Name der externen Datei angegeben, in dem der Text steht.

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
_rNoRec	5	Das übergebene Archiv wurde nicht gefunden
sAfErrNoRecArcTxt	-20018	Zu dem angegebenen Archiv existiert kein Archivtext
sAfErrNoRights	-20029	Die Berechtigungen reichen nicht aus
sAfErrArcTxtPageNotExists	-20033	Die in (int2) übergebene Textseite existiert nicht

Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.