TsgcWebSocketHTTPServerEvents › OnUnknownProtocol

OnUnknownProtocol Evento

Si attiva quando il primo messaggio non corrisponde a un protocollo noto, in modo che la connessione possa essere accettata o rifiutata.

Sintassi

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

Valore predefinito

Note

OnUnknownProtocol viene generato quando il server riceve i primi byte da un client in connessione e non riesce a riconoscere nessuno dei protocolli integrati (WebSocket, HTTP, SSE...). Viene tipicamente utilizzato per accettare client TCP semplici sullo stesso listener che serve HTTP. Impostare Accept su True per mantenere la sessione aperta (OnConnect verrà quindi generato come connessione TCP semplice) o su False per chiuderla. Il parametro Connection identifica la sessione; esaminare TsgcWSConnection.Transport o i byte grezzi già bufferizzati per decidere se consentire la connessione. Le connessioni non richieste possono essere rifiutate qui per ridurre l'utilizzo della CPU.

Esempio


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

Torna agli Eventi