TsgcHTTP3Server › Ereignisse › OnH3Disconnect

OnH3Disconnect Ereignis

Wird ausgelöst, wenn eine HTTP/3-Verbindung geschlossen wird.

Syntax

property OnH3Disconnect: TsgcQUICServerDisconnectEvent;
// TsgcQUICServerDisconnectEvent = procedure(Sender: TObject; const aConnection: TsgcQUICServerConnection; aCode: Int64; const aReason: string) of object

Standardwert

—

Parameter

NameTypBeschreibung
SenderTObjectDie TsgcHTTP3Server-Instanz, die das Ereignis ausgelöst hat.
aConnectionconst TsgcQUICServerConnectionVerbindung, die geschlossen wurde. In .NET ist dieser Parameter ein string, der den Peer-Endpunkt enthält und als Verbindungs-Id fungiert.
aCodeInt64Schließcode. Null für eine normale Schließung; andernfalls der zugrunde liegende Fehlercode.
aReasonconst stringMenschenlesbarer Grund für die Verbindungstrennung, sofern verfügbar.

Hinweise

OnH3Disconnect wird ausgelöst, wenn ein Client seine HTTP/3-Verbindung schließt oder wenn die Verbindung wegen eines Transportfehlers verworfen wird. Nach dem Ereignis wird das Verbindungsobjekt freigegeben, jeder von der Anwendung gehaltene Zustand pro Verbindung sollte daher hier verworfen werden, und die Referenz aConnection darf danach nicht mehr verwendet werden. Ein normales, vom Peer eingeleitetes Schließen meldet aCode = 0 mit einem leeren aReason; ein Schließen wegen eines Fehlers meldet den zugrunde liegenden Fehlercode und eine kurze Beschreibung.

Das Ereignis wird auch für jede von Stop abgebaute Verbindung ausgelöst, und es wird im Hintergrund-Listener-Thread des Servers ausgelöst, sodass es die Benutzeroberfläche nicht direkt berühren darf.

Beispiel


procedure OnH3DisconnectEvent(Sender: TObject; const aConnection:
    TsgcQUICServerConnection; aCode: Int64; const aReason: string);
begin
  Log('HTTP/3 client disconnected: ' + aReason);
end;

Zurück zu Ereignissen