TsgcHTTP3Server › Ereignisse › OnH3Disconnect
Wird ausgelöst, wenn eine HTTP/3-Verbindung geschlossen wird.
property OnH3Disconnect: TsgcQUICServerDisconnectEvent;
// TsgcQUICServerDisconnectEvent = procedure(Sender: TObject; const aConnection: TsgcQUICServerConnection; aCode: Int64; const aReason: string) of object
—
| Name | Typ | Beschreibung |
|---|---|---|
Sender | TObject | Die TsgcHTTP3Server-Instanz, die das Ereignis ausgelöst hat. |
aConnection | const TsgcQUICServerConnection | Verbindung, die geschlossen wurde. In .NET ist dieser Parameter ein string, der den Peer-Endpunkt enthält und als Verbindungs-Id fungiert. |
aCode | Int64 | Schließcode. Null für eine normale Schließung; andernfalls der zugrunde liegende Fehlercode. |
aReason | const string | Menschenlesbarer Grund für die Verbindungstrennung, sofern verfügbar. |
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.
procedure OnH3DisconnectEvent(Sender: TObject; const aConnection:
TsgcQUICServerConnection; aCode: Int64; const aReason: string);
begin
Log('HTTP/3 client disconnected: ' + aReason);
end;