Zum Hauptinhalt springen

C16_RecLinkInfo

C16_RecLinkInfo(const vPHANDLE aInstHdl, const vINT aSrcFileNo, const vINT aDstFileNo, const vINT aLinkNo, const vINT aInfoType, const vINT unused, vINT* aResult) : vERROR​

Informationen zu verknüpften Datensätzen ermitteln

Details

  • aInstHdl: Instanz-Handle
  • aSrcFileNo: Nummer der Quell-Datei
  • aDstFileNo: Nummer der Ziel-Datei
  • aLinkNo: Nummer der Verknüpfung
  • aInfoType: Informationstyp
  • unused: unbenutzt, muss 0 enthalten
  • aResult: Zeiger auf das Ergebnis
  • Resultat: vERROR Fehlerwert
  • Siehe: Befehle der Programmierschnittstelle

Der Befehl ermittelt Informationen zu einem verknüpften Datensatz. Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. Im Parameter (aScrFileNo) wird die Nummer der Ausgangsdatei, in (aDstFileNo) die Nummer der Zieldatei und in (aLinkNo) die Nummer der Verknüpfung angegeben, für welche die Informationen abgefragt werden sollen. Als Informationstyp stehen folgende symbolischen Konstanten zur Verfügung:

  • _RecCount: Anzahl der verknüpften Datensätze in der Zieldatei. Eine eventuelle Zugriffspositionierung wird dabei ignoriert.
  • _RecGetPos: Die Position des aktuellen Satzes der Zieldatei. Der erste verknüpfte Satz hat dabei die Nummer 1. Das Resultat ist -1, wenn der Satz nicht zur verknüpften Menge gehört.
  • _RecGetPosReverse: Analog zu _RecGetPos. Die Position des aktuellen Satzes innerhalb der Zieldatei wird jedoch nach umgekehrter Schlüsselsortierung ermittelt.
  • _RecCountPos: Anzahl aller verknüpften Datensätze ab der definierten Zugriffsposition. Der per Zugriffspositionierung verknüpfte Satz wird mitgezählt.
  • _RecCountNext: Die Anzahl verknüpfter Sätze nach dem aktuellen Satz in der Zieldatei. Das Resultat ist -1, wenn der Satz nicht zur verknüpften Menge gehört.

Der Parameter (unused) wird nicht verwendet und muss auf 0 gesetzt sein. Das Ergebnis steht in der Variablen, auf die der übergebene Zeiger (aResult) verweist.

Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler) oder einen negativen Fehlerwert (siehe Fehlerwerte ).