C16_KeyReorgStart

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.