Zum Hauptinhalt springen

C16_TextWrite

C16_TextWrite(const vPHANDLE aTextHdl, const vFLAGS aFlags, vC16_TextInfo* aTextInfo) : vERROR​

Textinformation speichern

Details

Mit dieser Funktion können die Textinformationen verändert werden. Die Textinformation muss vorher mit

C16_TextRead()

gelesen und gesperrt worden sein. Die veränderbaren Felder von (aTextInfo) sind bei

C16_TextRead()

aufgeführt. In (aTextHdl) wird der mit

C16_TextOpen()

erzeugte Handle eines Textpuffers übergeben. Der Parameter (aFlags) entscheidet, ob der Text nach Ausführung der Funktion weiter gesperrt bleibt (_TextLock) oder entsperrt wird (_TextUnlock).

Folgende Fehlerwerte vom Typ vERROR können zurückgegeben werden:

  • _rOk (0): Der Text wurde geschrieben.
  • _rNoLock (7): Der Text ist nicht gesperrt.
  • _rDeadlock (10): Der Text konnte aufgrund einer Verklemmung nicht gespeichert werden.
  • C16ERR_TEXT_HDL_INVALID: (aTextHdl) ist ungültig.
  • C16ERR_INFO_BLOCKSIZE_INVALID: In (aTextInfo) ist der Wert von InfoSize nicht korrekt.
  • C16ERR_TEXT_RIGHTS: Schreibberechtigung nicht ausreichend.
  • C16ERR_TEXT_GROUP_INVALID: Textgruppe (aTextInfo->TextGroup) ist länger als 20 Zeichen.