AfArcNonAllocatedLstGet: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Jens (Diskussion | Beiträge) K Jens verschob die Seite AFArcNonAllocatedLstGet nach AfArcNonAllocatedLstGet, 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"> AfArcNonAllocatedLstGet(int1) : 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 43: | Zeile 43: | ||
</table> | </table> | ||
<div class="BigLang"> | <div class="BigLang"> | ||
<p><p>Mit der Funktion lassen sich alle Archive ermitteln, die keiner Arbeitsmappe zugeordnet sind. Im Parameter (int1) muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[ | <p><p>Mit der Funktion lassen sich alle Archive ermitteln, die keiner Arbeitsmappe zugeordnet sind. Im Parameter (int1) 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 Archiv ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen und über die Eigenschaft "Name" die Archiv-Nummer und in der Eigenschaft "Custom" die Beschreibung des Archivs ausgelesen werden.</p> | <p>Nach dem Aufruf der Funktion ist pro Archiv ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen und über die Eigenschaft "Name" die Archiv-Nummer und in der Eigenschaft "Custom" die Beschreibung des Archivs ausgelesen werden.</p> | ||
| Zeile 68: | Zeile 68: | ||
if (tArcList > 0) | if (tArcList > 0) | ||
{ | { | ||
tErr # | tErr # AfArcNonAllocatedLstGet(tArcList); | ||
if (tErr = _ErrOk) | if (tErr = _ErrOk) | ||
{ | { | ||
| Zeile 82: | Zeile 82: | ||
else | else | ||
{ | { | ||
// Error handling | // Error handling AfAbmArcLstGet() | ||
... | ... | ||
} | } | ||
tArcList-> | tArcList->AfCteCloseAll(); | ||
} | } | ||
else | else | ||
Aktuelle Version vom 29. Oktober 2024, 13:42 Uhr
 |
|||||||||||||
| AfArcNonAllocatedLstGet(int1) : int |
|
||||||||||||
| Archive, die keiner Arbeitsmappe zugewiesen sind, ermitteln | |||||||||||||
|
|||||||||||||
Mit der Funktion lassen sich alle Archive ermitteln, die keiner Arbeitsmappe zugeordnet sind. Im Parameter (int1) 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 Archiv ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen und über die Eigenschaft "Name" die Archiv-Nummer und in der Eigenschaft "Custom" die Beschreibung des Archivs ausgelesen werden.
|
Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler. |
Beispiel:
local
{
tErr : int;
tArcList : handle;
tArcItem : handle;
tArcNo : alpha(12);
tArcDesc : alpha(250);
}
{
...
// Read all non-allocated archives
tArcList # AfCteOpen(_CteList);
if (tArcList > 0)
{
tErr # AfArcNonAllocatedLstGet(tArcList);
if (tErr = _ErrOk)
{
for tArcItem # tArcList->CteRead(_CteFirst);
loop tArcItem # tArcList->CteRead(_CteNext,tArcItem);
while (tArcItem > 0)
{
tArcNo # tArcItem->spName;
tArcDesc # tArcItem->spCustom;
...
}
}
else
{
// Error handling AfAbmArcLstGet()
...
}
tArcList->AfCteCloseAll();
}
else
{
// Error handling for AfCteOpen()
...
}
...
}
Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:
| Konstante | Wert | Bedeutung |
| _ErrOk | 0 | ok - kein Fehler aufgetreten |
| sAfErrItemLimit | -20015 | Die maximale Anzahl an übertragbaren Elementen (ca. 5000) wurde überschritten |
| sAfErrNoRights | -20029 | Der Benutzer hat nicht das Recht die nicht zugewiesenen Archive zu lesen. |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
