C16_RecBufCopy
C16_RecBufCopy(const vPHANDLE aInstHdl, const vINT aSrcFileNo, const vINT aDstFileNo, const vPHANDLE aSrcBuffHdl, const vPHANDLE aDstBuffHdl) : vERROR
Datensatzpuffer kopieren
Details
- aInstHdl: Instanz-Handle
- aSrcFileNo: Nummer der Quelldatei
- aDstFileNo: Nummer der Zieldatei
- aSrcBuffHdl: Handle des Quell-Puffers
- aDstBuffHdl: Handle des Ziel-Puffers
- Resultat: vERROR Fehlerwert
- Siehe: Befehle der Programmierschnittstelle , C16_RecBufCompare()
Diese Funktion kopiert den aktuellen Inhalt des Datensatzpuffers aus der Quelldatei (aSrcFileNo) in den Puffer der Zieldatei (aDstFileNo). In diesem Fall wird in den Parametern (aSrcBuffHdl) und (aDstBuffHdl) NULL übergeben. Wird anstelle einer Dateinummer der Handle eines mit C16_RecBufCreate() erzeugten Datensatzpuffers angegeben, so muss die Struktur der beiden Puffer übereinstimmen. In diesem Fall wird auch der aktuelle Satz-ID kopiert. Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben.
Mit dieser Funktion können auch Dateiinhalte unterschiedlicher Struktur kopiert werden. In diesem Fall wird, beginnend mit dem ersten Teildatensatz, solange Feld für Feld kopiert bis unterschiedliche Feldtypen zwischen Quell- und Zielpuffer festgestellt werden.
Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler) oder einen negativen Fehlerwert (siehe Fehlerwerte ).