Zum Hauptinhalt springen

C16_LinkFldInfo

C16_LinkFldInfo(const vPHANDLE aInstHdl, const vINT aFileNo, const vINT aLinkNo, const vINT aLinkFldNo, vC16_LinkFldInfo* aInfoBlock) : vERROR​

Information über ein Verknüpfungsfeld ermitteln

Details

  • aInstHdl: Instanz-Handle
  • aFileNo: Dateinummer
  • aLinkNo: Nummer der Verknüpfung
  • aLinkFldNo: Nummer des Verknüpfungsfeldes
  • aInfoBlock: Zeiger auf Informationsstruktur
  • Resultat: vERROR Fehlerwert
  • Siehe: Befehle der Programmierschnittstelle , C16_LinkInfo()

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

typedef struct
{
  vINT  InfoSize;
  vINT  LinkFldFileNumber;
  vINT  LinkFldSbrNumber;
  vINT  LinkFldNumber;
  vBYTE LinkFldType;
  vBYTE LinkFldAttributes;
  vBYTE LinkFldMaxLen;
  vBYTE reserved;
  vCHAR LinkFldName[24];
}
vC16_LinkFldInfo;
  • Komponente: Beschreibung
  • InfoSize: Größe der Struktur
  • LinkFldFileNumber: Nummer der Datei, in der das Verknüpfungsfeld definiert ist
  • LinkFldSbrNumber: Nummer des Teildatensatzes, in dem das Verknüpfungsfeld definiert ist
  • LinkFldNumber: Nummer des Verknüpfungsfeldes
  • LinkFldTyp: Wert Konstante C-Typ 1 _TypeAlpha vBYTE[FldLen+2] 2 _TypeDate vDATE 4 _TypeWord vWORD 7 _TypeInt vLONGs 9 _TypeFloat vFLOAT 10 _TypeLogic vBOOL8 11 _TypeTime vTIME
  • LinkFldAttribute: Attribute des Verknüpfungsfeldes 0x02 _LinkFldAttrUpperCase Großschreibung 0x04 _LinkFldAttrUmlaut Umlaute in alphabetischer Sortierung 0x08 _LinkFldAttrSpecialChars ohne Sonderzeichen 0x10 _LinkFldAttrSoundex1 Soundex Stufe 1 0x20 _LinkFldAttrSoundex2 Soundex Stufe 2 0x40 _LinkFldAttrReverse absteigende Sortierung 0x80 _LinkFldAttrPostion nur Zugriffspositionierung
  • LinkFldMaxLen: Die definierte Maximallänge des Verknüpfungsfeldes
  • reserved: Alignmend-Byte
  • LinkFldName[24]: Name des Verknüpfungsfeldes

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

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