C16_KeyReorgStart

C16_KeyReorgStart(const vPHANDLE aInstHdl, const vINT aFileNo, const vINT aKeyNo) : vERROR

Schlüsselreorganisation starten

Details

• aInstHdl: Instanz-Handle
• aFileNo: Dateinummer
• aKeyNo: Schlüsselnummer
• Resultat: vERROR Fehlerwert
• Siehe: Befehle der Programmierschnittstelle , C16_KeyReorgWatch()

Mit dieser Funktion wird die Reorganisation des Schlüssels (aKeyNo) in der Datei (aFileNo) gestartet. Die Funktion kehrt sofort zurück und liefert C16ERR_OK, wenn der Start erfolgreich war. Bei ungültigen Datei- oder Schlüsselnummern wird C16ERR_NO_FILE oder C16ERR_NO_KEY zurückgeliefert. Konnte der Server die Datenstruktur nicht laden oder den Reorganisationsthread nicht starten, wird der Fehler C16ERR_LOAD_DS bzw. C16ERR_SERVER_ASYNC (siehe Fehlerwerte ) zurückgegeben.

Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der an die Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben.

Nach dem Starten der Schlüsselreorganisation muss so lange der Befehl C16_KeyReorgWatch() aufgerufen werden, bis die Variable "Result" den Wert C16RES_ASYNC_TERM oder C16RES_ASYNC_BREAK enthält. Bis zu diesem Zeitpunkt können keine anderen Datenbankoperationen der DLL aufgerufen werden.