TsgcWSPClient_sgcMetodi › GetLastOffset

GetLastOffset Metodo

Restituisce l'ultimo offset di messaggio che il client ha visto su un canale.

Sintassi

function GetLastOffset(const aChannel: String): Int64;

Parametri

NomeTipoDescrizione
aChannelconst StringNome del canale di cui viene restituito l'offset tracciato.

Valore restituito

L'ultimo offset ricevuto sul canale. Restituisce 0 quando il client non ha ancora ricevuto alcun messaggio sul canale (o quando la Cronologia dei messaggi non è abilitata sul server).

Note

Il client mantiene un cursore per canale con l'offset dell'ultimo messaggio ricevuto mentre la Cronologia dei messaggi è abilitata sul server. Questo cursore è ciò che una semplice Subscribe invia alla riconnessione, in modo che il server ritrasmetta solo i messaggi che il client ha perso. Utilizzare GetLastOffset per ispezionare questo cursore, per esempio per persisterlo tra i riavvii dell'applicazione o per avviare una ritrasmissione esplicita con Subscribe(aChannel, aSinceOffset).

In .NET i metodi corrispondenti SetLastOffset e ClearOffsets consentono di ripristinare o reimpostare i cursori tracciati.

Esempio

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

Torna ai Metodi