AfArcAbmLstGet: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Jens (Diskussion | Beiträge) K Jens verschob die Seite AFArcAbmLstGet nach AfArcAbmLstGet, ohne dabei eine Weiterleitung anzulegen |
Jens (Diskussion | Beiträge) K Stand 4.1.09 |
||
| Zeile 6: | Zeile 6: | ||
</tr> | </tr> | ||
<tr class="ProcSyntax"> | <tr class="ProcSyntax"> | ||
<td class="title"> | <td class="title"> AfArcAbmLstGet(alpha1, int2) : int</td> | ||
<td class="platforms"> | <td class="platforms"> | ||
[[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht 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]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht 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]] | ||
| Zeile 51: | Zeile 51: | ||
<p><p>Mit der Funktion lassen sich alle Arbeitsmappen ermitteln, denen das übergebene Archiv zugeordnet ist. Die Archiv-Nummer wird über den Parameter (alpha1) übermittelt.</p> | <p><p>Mit der Funktion lassen sich alle Arbeitsmappen ermitteln, denen das übergebene Archiv zugeordnet ist. Die Archiv-Nummer wird über den Parameter (alpha1) übermittelt.</p> | ||
<p>Im zweiten Parameter muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[ | <p>Im zweiten Parameter muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[AfCteOpen#|AfCteOpen()]] angelegt wurde.</p> | ||
<p>Nach dem Aufruf der Funktion ist pro Arbeitsmappe ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaft "Name" kann die Arbeitsmappen-Nummer und über die Eigenschaft "Custom" der Arbeitsmappen-Name ausgelesen werden.</p> | <p>Nach dem Aufruf der Funktion ist pro Arbeitsmappe ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaft "Name" kann die Arbeitsmappen-Nummer und über die Eigenschaft "Custom" der Arbeitsmappen-Name ausgelesen werden.</p> | ||
| Zeile 76: | Zeile 76: | ||
if (tAbmList > 0) | if (tAbmList > 0) | ||
{ | { | ||
tErr # | tErr # AfArcAbmLstGet(tArcNo, tAbmList); | ||
if (tErr = _ErrOk) | if (tErr = _ErrOk) | ||
{ | { | ||
| Zeile 90: | Zeile 90: | ||
else | else | ||
{ | { | ||
// Error handling | // Error handling AfArcAbmLstGet() | ||
... | ... | ||
} | } | ||
tAbmList-> | tAbmList->AfCteCloseAll(); | ||
} | } | ||
else | else | ||
Aktuelle Version vom 18. Oktober 2024, 12:28 Uhr
 |
|||||||||||||||||
| AfArcAbmLstGet(alpha1, int2) : int |
|
||||||||||||||||
| Liste der Arbeitsmappen zum Archiv ermitteln | |||||||||||||||||
|
|||||||||||||||||
Mit der Funktion lassen sich alle Arbeitsmappen ermitteln, denen das übergebene Archiv zugeordnet ist. Die Archiv-Nummer wird über den Parameter (alpha1) übermittelt.
Im zweiten Parameter muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl AfCteOpen() angelegt wurde.
Nach dem Aufruf der Funktion ist pro Arbeitsmappe ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaft "Name" kann die Arbeitsmappen-Nummer und über die Eigenschaft "Custom" der Arbeitsmappen-Name ausgelesen werden.
|
Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler. |
Beispiel:
// Read all workfolders
local
{
tErr : int;
tArcNo : alpha(12);
tAbmList : handle;
tAbmItem : handle;
tAbmNo : int;
tAbmName : alpha(250);
}
{
tAbmList # AfCteOpen(_CteList);
if (tAbmList > 0)
{
tErr # AfArcAbmLstGet(tArcNo, tAbmList);
if (tErr = _ErrOk)
{
for tAbmItem # tAbmList->CteRead(_CteFirst);
loop tAbmItem # tAbmList->CteRead(_CteNext, tAbmItem);
while (tAbmItem > 0)
{
tAbmNo # CnvIA(tAbmItem->spName);
tAbmName # tAbmItem->spCustom;
...
}
}
else
{
// Error handling AfArcAbmLstGet()
...
}
tAbmList->AfCteCloseAll();
}
else
{
// Error handling AfCteOpen()
...
}
...
}
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 übergebenen Nummer. |
| sAfErrItemLimit | -20015 | Die maximale Anzahl an übertragbaren Elementen (ca. 5000) wurde überschritten. |
| sAfErrNoRights | -20029 | Die Berechtigungen reichen nicht aus. |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
