Zum Hauptinhalt springen

C16_TextRename

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

Text umbenennen

Details

Ein Text in der Datenbank wird umbenannt. Es darf noch kein Text mit dem neuen Namen vorhanden sein. Der Benutzer muss über eine ausreichende Schreibberechtigung für den Text verfügen. In (aTextHdl) oder (aTextName) wird der Text übergeben, der umbenannt werden soll. Wird der Text über seinen Namen angesprochen, muss in (aTextHdl) NULL übergeben werden.

Im Parameter (aTextNameNew) steht der neue Name des Textes (maximal 20 Stellen).

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

  • _rOk (0): Der Text wurde umbenannt.
  • _rLocked (1): Der Text ist gesperrt.
  • _rNoKey (3): Der Text ist nicht vorhanden.
  • _rExists (6): Es existiert bereits ein Text gleichen Namens.
  • 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.