C16_RecBufCreate

C16_RecBufCreate(const vPHANDLE aInstHdl, const vINT aFileNo, vPHANDLE* aBuffHdl) : vERROR

Datensatzpuffer anlegen

Details

• aInstHdl: Instanz-Handle
• aFileNo: Dateinummer
• aBuffHdl: Zeiger auf Datensatzpuffer
• Resultat: vERROR Fehlerwert
• Siehe: Befehle der Programmierschnittstelle , C16_RecBufDestroy()

Mit dieser Funktion wird ein zusätzlicher Datensatzpuffer für die Datei (aFileNo) im Hauptspeicher angelegt. Mit dem Handle des Puffers können anschließend die Funktionen C16_RecBufCopy() und C16_RecBufCompare() aufgerufen werden. Wenn der Puffer nicht mehr benötigt wird, muss er mit C16_RecBufDestroy() entfernt werden. Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. In (aFileNo) steht die Dateinummer der Datei, für die ein zusätzlicher Datensatzpuffer angelegt werden soll. (aBuffHdl) ist ein Zeiger auf eine Variable vom Typ vPHANDLE. Bei erfolgreicher Ausführung wird der Puffer-Handle in diese Variable geschrieben.

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