TsgcWebSocketServer_HTTPAPIEreignisse › OnAsynchronous

OnAsynchronous Ereignis

Wird ausgelöst, wenn eine vom HTTP-API-Server initiierte asynchrone Sendeoperation abgeschlossen ist.

Syntax

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

Standardwert

Hinweise

Wenn die Eigenschaft Asynchronous True ist, blockieren an einen Client geschriebene Nachrichten nicht den aufrufenden Thread: Der IOCP-Worker stellt den Sendevorgang in die Warteschlange und kehrt sofort zurück, und HTTP.SYS signalisiert den Abschluss später. OnAsynchronous wird für jeden abgeschlossenen asynchronen Vorgang ausgelöst, sodass die Anwendung die zugrunde liegenden Puffer freigeben oder wiederverwenden kann. Der Parameter aConnection verweist auf den TsgcHTTPAPIContext, der dem abgeschlossenen Request zugeordnet ist; setzen Sie Handled auf True, wenn die Anwendung den Kontext bereits freigegeben hat, um zu verhindern, dass die Komponente ihre Standardbereinigung ausführt. Wenn Asynchronous False ist (Standard), wird dieses Ereignis nie ausgelöst.

Beispiel


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

Zurück zu Ereignissen