Zum Hauptinhalt springen

C16_TextCopy

C16_TextCopy(const vPHANDLE aTextHdl, const vCHAR* aTextName, const vCHAR* aTextNameNew) : vERROR​

Text kopieren

Details

Der Befehl kopiert einen Text in der Datenbank. Es darf noch kein Text mit dem Namen der Kopie in der Datenbank vorhanden sein. Der Benutzer muss über eine ausreichende Leseberechtigung für den Ursprungstext verfügen. In (aTextHdl) wird der mit C16_TextOpen() erzeugte Handle eines Textpuffers oder in (aTextName) der Name eines Textes (aTextHdl ist dann NULL) übergeben, der kopiert werden soll. (aTextNameNew) ist der Name des neuen Textes (maximal 20 Zeichen). Wird sowohl (aTextHdl), als auch (aTextName) angegeben, hat der Handle vorrang.

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

  • _rOk (0): Der Text wurde kopiert.
  • _rLocked (1): Der Ursprungstext ist gesperrt.
  • _rNoKey (3): Der Ursprungstext ist nicht vorhanden.
  • _rExists (6): Es existiert bereits ein Text gleichen Namens.
  • _rDeadlock (10): Der Text konnte aufgrund einer Verklemmung nicht kopiert werden.
  • C16ERR_TEXT_HDL_INVALID: (aTextHdl) ist ungültig.
  • C16ERR_TEXT_NAME_INVALID: (aTextName) oder (aTextnameNew) ist ungültig.
  • C16ERR_TEXT_RIGHTS: Die Berechtigung ist nicht ausreichend.