Zum Hauptinhalt springen

C16_SelCreate

C16_SelCreate(const vPHANDLE aInstHdl, const vINT aFileNo, const vINT aKeyNo, const vINT aSourceFileNo) : vERROR​

Dynamische Selektion anlegen

Details

  • aInstHdl: Instanz-Handle
  • aFileNo: Dateinummer
  • aSourceFileNo: Weitere Ausgangsdatei oder 0 angeben.
  • Resultat: vERROR Deskriptor der neuen Selektion oder Fehlerwert
  • Siehe: Befehle der Programmierschnittstelle

Diese Funktion legt eine dynamische Selektion an. In aFileNo wird die Dateinummer übergeben. Soll die Seletkion nach einem Schlüssel sortiert sein, kann in aKeyNo die Nummer des entsprechenden Schlüssels übergeben werden. Soll eine andere oder keine Sortierung verwendet werden, wird hier 0 übergeben.

Das hier erzeugte Selektionsobjekt unterscheidet sich vom Selektionspuffer, der von der Funktion C16_SelOpen() angelegt wird. In dem Selektionspuffer kann eine Selektion durchgeführt werden. Mit dem dynamischen Selektionsobjekt kann eine Selektion erstellt werden.

In aSourcFileNo kann eine andere Ausgangsdatei angegeben werden. Dies ist dann sinnvoll, wenn über mindestens eine Verknüpfung zugegriffen werden soll und die Anzahl der Datensätze in dieser Verknüpfung geringer ist, als in der Datei, in der die Selektion angelegt wird. Ansonsten muss hier 0 übergeben werden.

in SelHdl wird ein Handle auf das angelegt Objekt zurückgegeben. Im Fehlerfall liefert die Funktion eine Resultat ungleich C16ERR_OK. Wird das Handle nicht mehr benötigt, muss dieses mit C16_SelClose wieder geschlossen werden.