TsgcWebSocketHTTPServerEvents › OnUnknownProtocol

OnUnknownProtocol Gebeurtenis

Wordt geactiveerd wanneer het eerste bericht niet overeenkomt met een bekend protocol, zodat de verbinding kan worden geaccepteerd of geweigerd.

Syntaxis

property OnUnknownProtocol: TsgcWSUnknownProtocolEvent;
// TsgcWSUnknownProtocolEvent = procedure(Connection: TsgcWSConnection; var Accept: Boolean) of object

Standaardwaarde

Opmerkingen

OnUnknownProtocol wordt geactiveerd wanneer de server de eerste bytes ontvangt van een verbindende client en geen van de ingebouwde protocollen kan herkennen (WebSocket, HTTP, SSE...). Het wordt typisch gebruikt om gewone TCP-clients te accepteren op dezelfde listener die HTTP bedient. Stel Accept in op True om de sessie open te houden (OnConnect wordt dan geactiveerd als een gewone TCP-verbinding) of op False om het te sluiten. De parameter Connection identificeert de sessie; inspecteer TsgcWSConnection.Transport of de rauwe bytes die al zijn gebufferd om te beslissen of de verbinding moet worden toegestaan. Ongewenste verbindingen kunnen hier worden afgewezen om het CPU-gebruik te verminderen.

Voorbeeld


procedure OnUnknownProtocol(Connection: TsgcWSConnection; var Accept: Boolean);
begin
  Accept := True;
end;

Terug naar gebeurtenissen