AfArcPos

AfArcPos(alpha1[, int2]) : int
Auf ein Archiv positionieren
alpha1 Nummer des Archives int2 Nummer der Arbeitsmappe (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfArcFilePos(), AfAbmPos()

Mit dieser Funktion wird in ArFlow auf ein bestimmtes Archiv positioniert. Die Nummer des Archivs wird in (alpha1) übergeben. Sollte das Archiv in mehreren Arbeitsmappen enthalten sein, kann die Arbeitsmappe in (int2) angegeben werden. Das Ergebnis dieser Anweisung wird in ArcFlow in einem neuen Dialog angezeigt.

Die Funktion kann nur mit der Application Remote Control verwendet werden. Die Parameter werden mit folgenden Namen übergeben:

/ArcNr	Nummer des Archivs
/AbmNr	Nummer der Arbeitsmappe
/RsltPath	Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.

Über den zusätzlichen Parameter /FLAGS kann das Verhalten der Applikation gesteuert werden:

Wert	Auswirkung
1	Die angegebene Arbeitsmappe wird als Root-Arbeitsmappe angezeigt.
2	Untergeordnete Arbeitsmappen werden aufgeklappt.
64	Die ArcFlow-Applikation wird im Vordergrund angezeigt.

Die Einzelnen Werte können miteinander kombiniert werden (/FLAGS=67 = Arbeitsmappe als Root, Untermappen aufgeklappt und Applikation im Vordergrund).

Zum Beispiel:
/user=admin /password=troja /action=open_dialog /fnc=AfArcPos /ArcNr=2008.0000012 /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.

Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
_rLocked	1	Das Archiv ist von einem anderen Benutzer gesperrt
_rNoRec	5	Das angegebene Archiv existiert nicht
sAfErrNoRights	-20029	Die Benutzerrechte reichen nicht aus

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