Zum Hauptinhalt springen

C16_FldInfo

C16_FldInfo(const vPHANDLE aInstHdl, const vINT aFileNo, const vINT aSbrNo, const vINT aFldNo, vC16_FldInfo* aInfoBlock) : vERROR​

Informationen über ein Feld ermitteln

Details

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

typedef struct
{
  vINT  InfoSize;
  vINT  FldFileNumber;
  vINT  FldSbrNumber;
  vINT  FldNumber;
  vBYTE FldType;
  vBYTE FldLen;
  vBYTE FldInputRight;
  vBYTE FldOutputRight;
  vCHAR FldName[24];
}
vC16_FldInfo;
  • Komponente: Beschreibung
  • InfoSize: Größe der Struktur
  • FldFileNumber: Nummer der Datei, in der das Feld definiert ist
  • FldSbrNumber: Nummer des Teildatensatzes, in dem das Feld definiert ist
  • FldNumber: Feldnummer
  • FldTyp: Typ entsprechender C-Typ 1 _TypeAlpha alphanumerisch vBYTE[FldLen + 2] 2 _TypeDate Datum vDATE 4 _TypeWord ganzzahlig kurz vWORD 7 _TypeInt ganzzahlig lang vLONGs 9 _TypeFloat numerisch vFLOAT 10 _TypeLogic logisch vBOOL8 11 _TypeTime Zeit vTIME
  • FldLen: Feldlänge (maximale Länge bei alphanumerischen Feldern)
  • FldInputRight: Eingabeberechtigung
  • FldOutputRight: Ausgabeberechtigung
  • FldName[24]: Feldname

Der Parameter (aInstHdl) ist der Instanz-Handle, der von der Funktion C16_InitInstance() bereitgestellt und an die Funktion C16_OpenArea() zum Öffnen der Datenbank übergeben wurde. Zur Identifikation des Feldes werden in den Parametern (aFileNo), (aSbrNo) und (aFldNo) die Datei-, die Teildatensatz- und die Feldnummer angegeben. In (aInfoBlock) wird ein Zeiger auf eine Informationsstruktur vom Typ vC16_FldInfo übergeben. Die Strukturkomponente InfoSize muss vor der Übergabe mit der Größe der Struktur initialisiert werden (sizeof(vC16_FldInfo)).

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