AFapi.ArcFileAdd

AFapi.ArcFileAdd(structure1, alpha2, logic3, int4) : int
Archiv ein Dokument hinzufügen
structure1 Nummer des Archives (typAFArcNo) alpha2 Name und Pfad der externen Datei logic3 Keine automatische Zuordnung int4 Nummer des Anhangs Resultat int Fehlerwert Siehe Verwandte Befehle, Strukturen

Die Funktion fügt die in (alpha2) angegebene Datei zu dem in (structure1) übergebenen Archiv hinzu.

Der Archiv-Datensatz wird zu diesem Zweck kurzzeitig gesperrt und nach dem Speichervorgang wieder entsperrt. Ist der Datensatz bereits von einem anderen Benutzer gesperrt, können die Inhalte nicht gespeichert werden und es wird der Wert _rLocked zurückgegeben.

Als Parameter (int4) muss eine ganzzahlige Variable angegeben werden, in der nach Aufruf der Funktion die Nummer des angelegten Anhangs zur Verfügung steht.

Soll keine automatische Zuordnung des Dokuments zu Arbeitsmappen erfolgen, muss im Parameter (logic4) true übergeben werden.

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.
_ErrFsiNoFile	-20	Die angegebene externe Datei existiert nicht.
_ErrFsiNoPath	-21	Der Pfad zu der angegebenen externen Datei existiert nicht.
_ErrFsiAccessDenied	-23	Der Zugriff auf die externe Datei wurde verweigert.
_ErrFsiLockViolation	-28	Sperrkonflikt in der externen Datei.
_ErrFsiOpenFailed	-29	Die externe Datei konnte nicht geöffnet werden.
_ErrBinNoPath	-1502	Der Pfad in der BLOB-Datenbank ist nicht vorhanden.
_ErrBinNoFile	-1503	Datei in der BLOB-Datenbank ist nicht vorhanden.
_ErrBinNoData	-1504	Datei in der BLOB-Datenbank ist leer.
_ErrBinNoLock	-1505	Datei in der BLOB-Datenbank ist nicht gesperrt.
_ErrBinLocked	-1506	Datei in der BLOB-Datenbank ist von einem anderen Benutzer gesperrt.
sAfErrNoRights	-20029	Die Berechtigungen sind nicht ausreichend.

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