C16_TextOpen
C16_TextOpen(const vPHANDLE aInstHdl, vPHANDLE* aTextHdl) : vERROR
Textpuffer anlegen
Details
- aInstHdl: Instanz-Handle
- aTextHdl: Text-Handle
- Resultat: vERROR Fehlerwert
- Siehe: Befehle der Programmierschnittstelle , C16_TextClose() , C16_TextReadData()
Der Befehl erzeugt einen Textpuffer und stellt den dazugehörigen Text-Handle in (aTextHdl). Ein Textpuffer wird für alle weiteren Textoperationen benötigt. Es können beliebig viele Textpuffer angelegt werden. Wird der Textpuffer nicht mehr verwendet, so muss er mit C16_TextClose() wieder 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.
Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler) oder einen negativen Fehlerwert (siehe Fehlerwerte ). Ist der Rückgabewert gleich C16ERR_INSTANCE_HDL_INVALID, ist der übergebene (aInstHdl) ungültig.