Zum Hauptinhalt springen

C16_FldInfoExtByName

C16_FldInfoExtByName(const vPHANDLE aInstHdl, const vCHAR* aFldName, vC16_FldInfoExt* aInfoBlock) : vERROR​

Informationen über ein Feld ermitteln

Details

Der Befehl füllt eine Struktur vom Typ vC16_FldInfoExt 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;
  vINT  FldLen;
  vINT  FldAttribute;
  vBYTE FldType;
  vBYTE FldInputRight;
  vBYTE FldOutputRight;
  vBYTE FldStatus;
  vCHAR FldName[24];
}
vC16_FldInfoExt;
  • 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
  • FldLen: Feldlänge (maximale Länge bei alphanumerischen Feldern)
  • FldAttribute: Feldattribute - Reserviert für zukünftige Versionen
  • 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
  • FldInputRight: Eingabeberechtigung
  • FldOutputRight: Ausgabeberechtigung
  • FldStatus: Feldstatus - Reserviert für zukünftige Versionen
  • 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 wird im Parameter (aFldName) der Name des Feldes angegeben. In (aInfoBlock) wird ein Zeiger auf eine Informationsstruktur vom Typ vC16_FldInfoExt übergeben. Die Strukturkomponente InfoSize muss vor der Übergabe mit der Größe der Struktur initialisiert werden (sizeof(vC16_FldInfoExt)).

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