AfArcNonAllocatedLstGet: Unterschied zwischen den Versionen

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
Die Seite wurde neu angelegt: „<languages /> <translate> <table class=head> <tr> <td class="BigTitle" colspan="2" align="center">file:DE_Schriftzug.gif</td> </tr> <tr clas…“
 
K Stand 4.1.09
 
(2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 6: Zeile 6:
   </tr>
   </tr>
   <tr class="ProcSyntax">
   <tr class="ProcSyntax">
     <td class="title">&nbsp;AFArcNonAllocatedLstGet(int1) : int</td>
     <td class="title">&nbsp;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 33: Zeile 33:
   <td width="15%" class=Left>Siehe</td>
   <td width="15%" class=Left>Siehe</td>
   <td width="85%" class=Right colspan="3">
   <td width="85%" class=Right colspan="3">
[[Befehle für Archive#|Verwandte Befehle]]
[[:Category:Befehle für Archive|Verwandte Befehle]]
   </td>
   </td>
</tr>
</tr>
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 [[AFCteOpen#|AfCteOpen()]] angelegt wurde.</p>
<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 &gt; 0)
   if (tArcList &gt; 0)
   {
   {
     tErr # AFArcNonAllocatedLstGet(tArcList);
     tErr # AfArcNonAllocatedLstGet(tArcList);
     if (tErr = _ErrOk)
     if (tErr = _ErrOk)
     {
     {
Zeile 82: Zeile 82:
     else
     else
     {
     {
       // Error handling AFAbmArcLstGet()
       // Error handling AfAbmArcLstGet()
       ...
       ...
     }
     }
     tArcList-&gt;AFCteCloseAll();
     tArcList-&gt;AfCteCloseAll();
   }
   }
   else
   else
Zeile 135: Zeile 135:
</translate>
</translate>
[[Category:Befehle für Archive]]
[[Category:Befehle für Archive]]
[[Category:ListeAllerApiBefehleA]]

Aktuelle Version vom 29. Oktober 2024, 13:42 Uhr

 AfArcNonAllocatedLstGet(int1) : int

Ausführbar von der APINicht ausführbar von der Programmierschnittstelle (DLL)Nicht ausführbar mit der Application Remote ControlAusführbar von der Script-API

Archive, die keiner Arbeitsmappe zugewiesen sind, ermitteln
int1 Deskriptor einer leeren CTE-Liste
Resultat int Fehlerwert
Siehe

Verwandte Befehle

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.