Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (Deutsch) » MobiLink - Clientadministration » SQL Anywhere-Clients für MobiLink » Dbmlsync-API » Dbmlsync-API für C++

 

DBSC_Event-Struktur

Die Struktur DBSC_Event enthält Informationen über eine angeforderte Synchronisation. Die Struktur wird folgendermaßen festgelegt:

typedef struct {
    DBSC_SyncHdl hdl;  
    DBSC_EventType type;
    const char   *str1;
    const char  *str2;
    long int  val1;
    long int  val2;
    void   *data;
} DBSC_Event;

Das Feld hdl identifiziert die Synchronisationsanforderung, zu der die Struktur Informationen enthält. Dieser Wert entspricht dem Handle, das von der Sync-Methode zurückgegeben wurde.

Das Feld type identifiziert den Ereignistyp, zu dem Informationen gegeben werden.

Die übrigen Felder enthalten zusätzliche Daten. Worum es sich bei ihnen handelt, hängt vom Wert im Feld type ab. Die folgende Liste enthält die möglichen Typenwerte und die Bedeutung der anderen Felder, die den Typen zugeordnet sind.

  • DBSC_EVENTTYPE_ERROR_MSG   Die Synchronisation hat einen Fehler generiert, und str1 zeigt auf den Fehlertext.

  • DBSC_EVENTTYPE_WARNING_MSG   Die Synchronisation hat eine Warnung generiert, und str1 zeigt auf den Text der Warnung.

  • DBSC_EVENTTYPE_INFO_MSG   Die Synchronisation hat eine Meldung generiert, und str1 zeigt auf den Meldungstext.

  • DBSC_EVENTTYPE_PROGRESS_INDEX   Stellt die Informationen für die Aktualisierung des Fortschrittsbalkens bereit. val1 enthält den neuen Wert des Verarbeitungsfortschritts. Der verarbeitete Prozentwert kann ermittelt werden, indem val1 durch 1000 dividiert wird.

  • DBSC_EVENTTYPE_PROGRESS_TEXT   Der dem Fortschrittsbalken zugeordnete Text wurde aktualisiert, und str1 zeigt auf den neuen Wert.

  • DBSC_EVENTTYPE_TITLE   Der Titel des Synchronisationsfensters/Steuerelements wurde geändert, und str1 zeigt auf den neuen Titel.

  • DBSC_EVENTTYPE_SYNC_START   Die Synchronisation wurde gestartet. Es gibt keine zusätzlichen Informationen zu diesem Ereignis.

  • DBSC_EVENTTYPE_SYNC_DONE   Die Synchronisation ist abgeschlossen, und val1 enthält den Beendigungscode aus der Synchronisation. Der Wert 0 zeigt Erfolg an. Ein Wert ungleich Null zeigt an, dass die Synchronisation fehlgeschlagen ist.