Zum Hauptinhalt springen

C16_SbrInfo

C16_SbrInfo(const vPHANDLE aInstHdl, const vINT aFileNo, const vINT aSbrNo, vC16_SbrInfo* aInfoBlock) : vERROR​

Informationen zu einem Teildatensatz ermitteln

Details

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), die Nummer der Datei und 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 ).