Zum Hauptinhalt springen

C16_RecInfo64

C16_RecInfo64(const vPHANDLE aInstHdl, const vINT aFileNo, const vINT aInfoType, const vXLONG aKeyNo, vXLONG* aResult) : vERROR​

Informationen zu einem Datensatz ermitteln

Details

Der Befehl ermittelt Informationen zu einem Datensatz. Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. Im Parameter (aFileNo) wird die Dateinummer angegeben für welche die Informationen abgefragt werden sollen. Als Informationstyp stehen folgende symbolischen Konstanten zur Verfügung:

  • _RecCount: Mit dieser Option wird die Anzahl der Datensätze in der Datei ermittelt.
  • _RecID: Das Resultat ist die interne ID des aktuell geladenen Satzes. Das Resultat ist ungültig, wenn kein Satz aus der Datei geladen ist.
  • _RecSetID: Die Datensatz-ID wird auf den in (aKeyNo) übergebenen Wert gesetzt. Mit diesem Befehl kann die Datensatz-ID zurückgesetzt werden. Das Zurückschreiben eines Datensatzes mit dem Befehl C16_RecReplace erfolgt über die Datensatz-ID. Durch eine Änderung der Datensatz-ID kann der ursprünglich gelesene Datensatz nicht mehr zurückgeschrieben werden.
  • _RecLen: Die effektive Länge des im Hauptspeicher befindlichen Datensatzes in der Datei wird ermittelt. Das Resultat gibt die Größe des Datensatzes in Bytes zurück. In der effektiven Länge sind alphanumerische Felder nur mit ihrer aktuellen Länge berücksichtigt.
  • _RecLenPacked: Die gepackte Länge des zuletzt gelesenen (z. B. C16_RecRead ) oder geschriebenen (z. B. C16_RecInsert ) Datensatzes in der Datei wird ermittelt. Änderungen am Feldpuffer werden nicht berücksichtigt. Das Resultat gibt die gepackte Größe des Datensatzes in Bytes zurück.
  • _RecLockedBy: Wird auf einen gesperrten Datensatz zugegriffen, so kann hiermit die ID-Nummer des Benutzers ermittelt werden, der den Datensatz gesperrt hat.
  • _RecGetPos: Die Position des aktuellen Satzes innerhalb der Datei (nach Schlüsselsortierung). Die Schlüsselposition eines Satzes gibt allerdings nur die ungefähre Position an. Die Nummer des Schlüssels wird mit (aKeyNo) angegeben.
  • _RecGetPosReverse: Analog zu _RecGetPos, die Position des aktuellen Satzes innerhalb der Datei wird jedoch nach umgekehrter Schlüsselsortierung ermittelt.
  • _RecGetPrime: Das Resultat ist der Prime-Counter der Datei. Dieser Wert wird jedes Mal verändert, wenn ein Datensatz hinzugefügt wird. Wird ein Datensatz gelöscht, verändert sich der Wert nicht.

Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler) oder einen negativen Fehlerwert (siehe Fehlerwerte ).