AfArcAbmAdd

AfArcAbmAdd(alpha1, int2[, logic3]) : int
Archiv zu einer Arbeitsmappe hinzufügen
alpha1 Nummer des Archives int2 Nummer der Arbeitsmappe logic3 Fehler bei vorhandener Zuweisung (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfArcAbmDelete()

Mit der Funktion lässt sich das in (alpha1) übergebene Archiv zu der in (int2) übergebenen Arbeitsmappe hinzufügen. Ist das Archiv bereits in der Arbeitsmappe enthalten, wird der Wert _rOk zurückgegeben. Soll auch in diesem Fall ein Fehler zurückgegeben werden, muss in (logic3) true übergeben werden. Ist in (int2) eine Vorlagemappe angegeben, ist das Resultat sAfErrNoRights (-20029). Bei erfolgreicher Durchführung der Funktion wird der Wert _ErrOk zurückgegeben.

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

/ArcNr	Nummer des Archivs
/AbmNr	Nummer der Arbeitsmappe
/ErrOnExist	Fehlerrückgabe bei vorhandener Zuweisung
/RsltPath	Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.

Zum Beispiel:
/user=admin /password=troja /action=fnc /fnc=AfArcAbmAdd /ArcNr=2008.0000012 /AbmNr=600448 /ErrOnExist=true /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
_rNoRec	5	Es existiert kein Archiv mit der in (alpha1) angegebenen Nummer.
_rExists	6	Das Archiv ist bereits der Arbeitsmappe zugeordnet (nur, wenn logic3 = true)
sAfErrNoRecAbm	-20026	Die in (int2) übergebene Arbeitsmappe existiert nicht.
sAfErrNoRights	-20029	Die Berechtigungen reichen nicht aus.

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