TsgcWebSocketServer_HTTPAPIEventos › OnAsynchronous

OnAsynchronous Evento

Disparado quando uma operação de envio assíncrona iniciada pelo servidor da HTTP API foi concluída.

Sintaxe

property OnAsynchronous: TsgcWSHTTPAPIAsynchronousEvent;
// TsgcWSHTTPAPIAsynchronousEvent = procedure(Sender: TObject; var aConnection: TsgcHTTPAPIContext; var Handled: Boolean) of object

Valor Padrão

Observações

Quando a propriedade Asynchronous é True, as mensagens escritas para um cliente não bloqueiam a thread chamadora: o worker IOCP enfileira o envio e retorna imediatamente, e o HTTP.SYS sinaliza a conclusão posteriormente. O OnAsynchronous é gerado para cada operação assíncrona concluída, para que a aplicação possa liberar ou reutilizar os buffers subjacentes. O parâmetro aConnection aponta para o TsgcHTTPAPIContext associado à requisição concluída; defina Handled como True quando a aplicação já tiver descartado o contexto, para impedir que o componente execute sua limpeza padrão. Se Asynchronous for False (o padrão), este evento nunca é gerado.

Exemplo


procedure OnAsynchronous(Sender: TObject; var aConnection: TsgcHTTPAPIContext;
  var Handled: Boolean);
begin
  DoLog('async write completed');
  Handled := False;
end;

Voltar para Eventos