TsgcWebSocketServer_HTTPAPI › Gebeurtenissen › OnAsynchronous

OnAsynchronous Gebeurtenis

Wordt geactiveerd wanneer een asynchrone verzendbewerking die door de HTTP API-server is gestart, is voltooid.

Syntaxis

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

Standaardwaarde

—

Opmerkingen

Wanneer de eigenschap Asynchronous True is, blokkeren berichten die naar een client worden geschreven de aanroepende thread niet: de IOCP-worker plaatst het verzenden in de wachtrij en keert onmiddellijk terug, en HTTP.SYS geeft later de voltooiing aan. OnAsynchronous wordt gegenereerd voor elke voltooide asynchrone bewerking zodat de toepassing de onderliggende buffers kan vrijgeven of hergebruiken. De parameter aConnection wijst naar de TsgcHTTPAPIContext die is gekoppeld aan het voltooide verzoek; stel Handled in op True wanneer de toepassing de context al heeft verwijderd om te voorkomen dat de component de standaard opruiming uitvoert. Als Asynchronous False is (de standaard), wordt deze gebeurtenis nooit gegenereerd.

Voorbeeld

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

Terug naar gebeurtenissen