C16_SbrInfoByName

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

typedef struct
{
  vINT  InfoSize;
  vINT  SbrFileNumber;
  vINT  SbrNumber;
  vBOOL SbrStatus;
  vINT  SbrFldCount;
  vCHAR SbrName[24];
}
vC16_SbrInfo;

• Komponente: Beschreibung
• InfoSize: Größe der Struktur
• SbrFileNumber: Nummer der Datei, in welcher der Teildatensatz definiert ist
• SbrNumber: Teildatensatznummer
• SbrStatus: Status des Teildatensatzes (0 = Teildatensatz ist nicht aktiv, 1 = Teildatensatz ist aktiv)
• SbrFldCount: Anzahl der Felder im Teildatensatz
• SbrName[24]: Name des Teildatensatzes

Als Parameter der Funktion müssen der von C16_InitInstance() bereitgestellte Instanz-Handle, der an die Funktion C16_OpenArea() zum Öffnen der Datenbank übergeben wurde (aInstHdl), der Name des Teildatensatzes, zu dem die Informationen ermittelt werden sollen und ein Zeiger auf eine vC16_SbrInfo-Struktur, die mit Informationen zu der Datei gefüllt wird, übergeben werden. Die Strukturkomponente InfoSize muss vor der Übergabe mit der Größe der Struktur initialisiert werden (sizeof(vC16_SbrInfo)).

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