Cancel-Methode (Replikation)
Anwendungen rufen die Cancel-Methode auf, um eine zurzeit ausgeführte Synchronisierung abzubrechen.
Syntax
object.Cancel()
Betrifft
Replikationsobjekt von SQL Server 2005 Compact Edition
Prototyp
HRESULT Cancel();
Rückgabewerte
| Rückgabecode | Beschreibung |
|---|---|
S_OK |
Die Methode wurde erfolgreich abgeschlossen. |
Beliebiger FAILED(HRESULT)-Wert |
Weitere Informationen zu den Fehlern finden Sie in der SSCEErrors-Auflistung. |
Hinweise
Wenn die Synchronisierung gestartet wurde, wird sie synchron ausgeführt. Die Cancel-Methode kann von einem anderen Thread oder von einer Benutzerimplementierung der Schnittstelle für den Replikationsstatusbericht ausgeführt werden.
Wenn die Cancel-Methode aufgerufen wird, ist das Abbruchverhalten abhängig von der zurzeit ausgeführten Synchronisierungsphase, wie in der folgenden Bedingungsliste aufgeführt ist:
| Wenn die Synchronisierung abgebrochen wird... | ...tritt dieses Verhalten auf |
|---|---|
Während der Uploadphase, bevor die IN-Nachricht vollständig ist und bevor die SQL Server-Synchronisierung aufgerufen wurde |
Die Synchronisierung wird vollständig abgebrochen. |
Wenn die IN-Nachricht vollständig ist und die SQL Server-Synchronisierung aufgerufen wurde |
Nur der Downloadabschnitt der Synchronisierung wird abgebrochen. Die OUT-Nachricht wird generiert, jedoch nicht gedownloadet und schließlich während des Bereinigungsprozesses gelöscht. |
Nachdem die OUT-Nachricht erstellt und gedownloadet wurde |
Einige der Änderungen werden möglicherweise verarbeitet, jedoch nicht unbedingt alle. |
Siehe auch
Referenz
Schnittstelle für den Replikationsstatusbericht