af_rmtcontrol.exe /user=admin /password=troja /action=fnc /fnc=AfArcFileDataEdit /ArcNr=2008.0000012 /ArcFileNr=1 /ArcFileType=1 /ArcContent="Neue Beschreibung" /RsltPath=c:\temp\AFAPIRES.TXTIn der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.
AfArcFileDataEdit: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Afwiki (Diskussion | Beiträge) K Stand 4.1.08 Buchstaben Kategorie entfernt |
Jens (Diskussion | Beiträge) K Stand 4.1.13 Beispiel geändert, Helptip Ausführung angepasst |
||
| (2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> AfArcFileDataEdit(alpha1, int2, int3, alpha4) : int</td> | ||
<td class="platforms"> | <td class="platforms"> | ||
[[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolDLL.gif|alt=Ausführbar von der Programmierschnittstelle|link=Befehle der Schnittstellen]][[file:DE_SymbolARC.gif|alt=Ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen]] | [[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen|Ausführbar von der API]][[file:DE_SymbolDLL.gif|alt=Ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen|Ausführbar von der Programmierschnittstelle (DLL)]][[file:DE_SymbolARC.gif|alt=Ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen|Ausführbar mit der Application Remote Control]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen|Ausführbar von der Script-API]] | ||
</td> | </td> | ||
</tr> | </tr> | ||
| Zeile 52: | Zeile 52: | ||
<td width="85%" class=Right colspan="3"> | <td width="85%" class=Right colspan="3"> | ||
[[:Category:Befehle für Archive|Verwandte Befehle]], | [[:Category:Befehle für Archive|Verwandte Befehle]], | ||
[[ | [[AfArcFileLstGet#|AfArcFileLstGet]] | ||
</td> | </td> | ||
| Zeile 121: | Zeile 121: | ||
</table> | </table> | ||
== Beispiele == | |||
< | <tabber> | ||
geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.</ | |-|ArcFlowRemoteControl= | ||
<pre class=source> | |||
af_rmtcontrol.exe /user=admin /password=troja /action=fnc /fnc=AfArcFileDataEdit /ArcNr=2008.0000012 /ArcFileNr=1 /ArcFileType=1 /ArcContent="Neue Beschreibung" /RsltPath=c:\temp\AFAPIRES.TXT | |||
</pre> | |||
In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert. | |||
</tabber> | |||
<p> | <p> | ||
Aktuelle Version vom 13. Januar 2026, 10:01 Uhr
 |
|||||||||||||||||||||||||
| AfArcFileDataEdit(alpha1, int2, int3, alpha4) : int |
|
||||||||||||||||||||||||
| Daten einer Anhangdatei ändern | |||||||||||||||||||||||||
|
|||||||||||||||||||||||||
Mit dieser Funktion können der Name oder die Beschreibung der Anhangdatei (int2) des Archivs (alpha1) geändert werden.
Der Typ der Änderung wird in (int3) angegeben. Folgende Typen stehen zur Verfügung:
| Konstante | Wert | Beschreibung |
| sAfArcFileDataName | Der Name der Anhangdatei wird geändert | |
| sAfArcFileDataDescr | Die Beschreibung der Anhangdatei wird geändert | |
| sAfArcFileDataModeEffect | Die Drehrichtung der Anhangdatei wird geändert. Diese Änderung ist nur bei Bilddateien möglich. |
Der zu setzende Wert wird in (alpha4) übergeben. Bei Angabe der Konstante sAfArcFileDataModeEffect in (int3) muss der Wert (_WinModeEffektRot90L, _WinModeEffektRot90R oder _WinModeEffektRot180) mit CnvAI() in einen Alphawert konvertiert werden.
Nach erfolgreicher Durchführung der Funktion wird _rOk zurückgegeben.
Bei der Verwendung mit der Application Remote Control werden die Parameter mit folgenden Namen übergeben:
| /ArcNr | Nummer des Archivs |
| /ArcFileNr | Nummer der Anhangdatei |
| /ArcFileType | Typ der Archivinformation |
| /ArcContent | Archivinformation |
| /RsltPath | Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird. |
Beispiele
Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:
| Konstante | Wert | Bedeutung |
| _rOk | 0 | ok - Kein Fehler aufgetreten |
| _rLocked | 1 | Datensatz ist gesperrt |
| _rNoRec | 5 | Kein Datensatz vorhanden - es existiert kein Archiv mit der übergebenen Nummer |
| _rDeadLock | 10 | Es ist eine Verklemmung aufgetreten |
| sAfErrInvalidFileType | -20012 | Dateityp ist ungültig |
| sAfErrInvalidArgValue | -20013 | Ungültiger Argumentwert übergeben |
| sAfErrNoRights | -20029 | Berechtigung nicht ausreichend |
| sAfErrArcFileNotExists | -20031 | Anhangdatei zu einem Archiv existiert nicht |
| sAfErrInvalidProperty | -20043 | Ungültige Eigenschaft |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
