ul_synch_info_a-Struktur

Die Struktur, mit der die Synchronisationsdaten beschrieben werden.

Syntax

public ul_synch_info_a

Eigenschaften

Name	Typ	Beschreibung
additional_parms	const char *	Eine Zeichenfolge mit zusätzlichen Synchronisationsparametern in Form einer durch Semikola getrennten Liste von Schlüsselwort=Werte-Paaren. Dieses Feld enthält üblicherweise Synchronisationsparameter, die nur selten verwendet werden. Weitere Hinweise finden Sie unter Synchronisationsparameter Additional Parameters.
auth_parms	char **	Stellt ein Array von Authentifizierungsparametern in MobiLink-Ereignissen bereit.
auth_status	ul_auth_status	Der Status der MobiLink-Benutzerauthentifizierung. Der MobiLink-Server gibt diese Information an den Client weiter.
auth_value	ul_s_long	Die Ergebnisse eines benutzerdefinierten Benutzerauthentifizierungsskripts in MobiLink. Der MobiLink-Server stellt diese Informationen dem Client bereit, um den Authentifzierungsstatus zu ermitteln.
download_only	ul_bool	Führt während der aktuellen Synchronisation keinen Upload der Änderungen in der UltraLite-Datenbank durch.
ignored_rows	ul_bool	Der Status der ignorierten Zeilen. Dieses schreibgeschützte Feld gibt Auskunft darüber, ob Zeilen vom MobiLink-Server während der Synchronisation aufgrund fehlender Skripten ignoriert wurden.
init_verify	ul_synch_info_a *	Initialisiert die Verifizierung.
keep_partial_download	ul_bool	Wenn ein Download wegen eines Kommunikationsfehlers während der Synchronisation fehlschlägt, steuert dieser Parameter, ob UltraLite den teilweisen Download fortsetzt oder die Änderungen zurücksetzt.
new_password	char *	Eine Zeichenfolge, die ein neues MobiLink-Kennwort festlegt, das dem Benutzernamen zugeordnet ist. Dieser Parameter ist optional.
num_auth_parms	ul_byte	Die Anzahl der Authentifizierungsparameter, die an die Authentifizierungsparameter in MobiLink-Ereignissen übergeben werden.
observer	ul_synch_observer_fn	Ein Zeiger auf eine Callback-Funktion oder einen Event-Handler, der die Synchronisation überwacht. Dieser Parameter ist optional.
partial_download_retained	ul_bool	Wenn ein Download wegen eines Kommunikationsfehlers während der Synchronisation fehlschlägt, wird durch diesen Parameter angegeben, ob UltraLite die geladenen Änderungen übernommen anstatt zurückgesetzt hat.
password	char *	Eine Zeichenfolge, die das MobiLink-Kennwort festlegt, das dem Benutzernamen zugeordnet ist. Dieser Parameter ist optional.
ping	ul_bool	Bestätigung von Kommunikationen zwischen dem UltraLite-Client und dem MobiLink-Server. Wenn dieser Parameter auf TRUE gesetzt wird, findet keine Synchronisation statt.
publications	const char *	Eine kommagetrennte Liste von Publikationen, die anzeigt, welche Daten in die Synchronisation einzubeziehen sind.
resume_partial_download	ul_bool	Setzt einen fehlgeschlagenen Download fort. Die Synchronisation sendet keine Änderungen beim Upload und lädt nur die Änderungen, die beim fehlgeschlagenen Download geladen werden sollten.
send_column_names	ul_bool	Weist die Anwendung an, dass Spaltennamen beim Upload an den MobiLink-Server gesendet werden.
send_download_ack	ul_bool	Informiert den MobiLink-Server, ob der Client eine Downloadbestätigung sendet.
stream	const char *	Das MobiLink-Netzwerkprotokoll zur Verwendung in der Synchronisation.
stream_error	ul_stream_error	Die Struktur, die Berichtsinformationen zu Kommunikationsfehlern enthält.
stream_parms	char *	Die Optionen zum Konfigurieren des ausgewählten Netzwerkprotokolls.
upload_ok	ul_bool	Der Status der Daten, die auf den MobiLink-Server übertragen wurden. Dieses Feld hat den Wert TRUE, wenn der Upload erfolgreich war.
upload_only	ul_bool	Lädt während der aktuellen Synchronisation keine Änderungen von der konsolidierten Datenbank herunter. Dies kann Verbindungszeit sparen, vor allem bei langsamen Verbindungen.
user_data	ul_void *	Übergabe von anwendungsspezifischen Informationen an die Synchronisations-Beobachtungsfunktion. Dieser Parameter ist optional.
user_name	char *	Eine Zeichenfolge, die der MobiLink-Server verwendet, um einen eindeutigen MobiLink-Benutzer zu identifizieren.
version	char *	Die Versionszeichenfolge gestattet es einer UltraLite-Anwendung, zwischen einer Reihe von Synchronisationsskripten zu wählen.

Bemerkungen

Die Synchronisationsparameter steuern das Synchronisationsverhalten zwischen einer UltraLite-Datenbank und dem MobiLink-Server. Dazu sind die Synchronisationsparameter Stream Type, User Name und Version erforderlich. Wenn Sie diese nicht angeben, gibt die Synchronisation einen Fehler zurück (SQLE_SYNC_INFO_INVALID oder äquivalenten Fehler). Es darf jeweils nur einer der Parameter Download Only, Ping oder Upload Only angegeben werden. Wenn Sie mehrere dieser Parameter auf TRUE setzen, gibt die Synchronisation einen Fehler zurück (SQLE_SYNC_INFO_INVALID oder äquivalenten Fehler).

Kommentieren Sie diese Seite in DocCommentXchange.
Senden Sie uns Feedback über diese Seite via E-Mail.