Zum Hauptinhalt springen

C16_LinkInfo

C16_LinkInfo(const vPHANDLE aInstHdl, const vINT aFileNo, const vINT aLinkNo, vC16_LinkInfo* aInfoBlock) : vERROR​

Informationen über eine Verknüpfung ermitteln

Details

Der Befehl füllt eine Struktur vom Typ vC16_LinkInfo mit Informationen zu einer in der Datenstruktur definierten Verknüpfung. Die Struktur ist folgendermaßen definiert:

typedef struct
{
  vINT  InfoSize;
  vINT  LinkFileNumber;
  vINT  LinkNumber;
  vINT  LinkFldCount;
  vINT  LinkDestFileNumber;
  vINT  LinkDestKeyNumber;
  vCHAR LinkName[24];
}
vC16_LinkInfo;
  • Komponente: Beschreibung
  • InfoSize: Größe der Struktur
  • LinkFileNumber: Nummer der Datei, in der die Verknüpfung definiert ist
  • LinkNumber: Verknüpfungsnummer
  • LinkFldCount: Anzahl der Verknüpfungsfelder
  • LinkDestFileNumber: Nummer der verknüpften Datei
  • LinkDestKeyNumber: Schlüsselnummer der verknüpften Datei
  • LinkName[24]: Name der Verknüpfung

Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. In den Parametern (aFileNo) und (aLinkNo) müssen sich die Dateinummer und die Nummer der Verknüpfung befinden, von dem die Informationen abgefragt werden sollen. In (aInfoBlock) wird ein Zeiger auf eine Informationsstruktur vom Typ vC16_LinkInfo übergeben. Die Strukturkomponente InfoSize muss vor der Übergabe mit der Größe der Struktur initialisiert werden (sizeof(vC16_LinkInfo)).

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