TsgcWSPClient_sgcMethoden › GetLastOffset

GetLastOffset Methode

Gibt den letzten Nachrichten-Offset zurück, den der Client auf einem Kanal gesehen hat.

Syntax

function GetLastOffset(const aChannel: String): Int64;

Parameter

NameTypBeschreibung
aChannelconst StringName des Kanals, dessen verfolgter Offset zurückgegeben wird.

Rückgabewert

Der letzte auf dem Kanal empfangene Offset. Gibt 0 zurück, wenn der Client noch keine Nachricht auf dem Kanal empfangen hat (oder wenn der Nachrichtenverlauf auf dem Server nicht aktiviert ist).

Hinweise

Der Client führt pro Kanal einen Cursor mit dem Offset der letzten Nachricht, die er empfangen hat, während der Nachrichtenverlauf auf dem Server aktiviert ist. Diesen Cursor sendet ein einfaches Subscribe bei der Wiederverbindung, sodass der Server nur die Nachrichten erneut sendet, die der Client verpasst hat. Verwenden Sie GetLastOffset, um diesen Cursor zu prüfen, zum Beispiel, um ihn über Anwendungsneustarts hinweg zu persistieren oder eine explizite Wiederholung per Subscribe(aChannel, aSinceOffset) anzustoßen.

In .NET ermöglichen die passenden Methoden SetLastOffset und ClearOffsets das Wiederherstellen oder Zurücksetzen der verfolgten Cursor.

Beispiel

LastOffset := oProtocol.GetLastOffset('news');

Zurück zu Methoden