TsgcWebSocketServer_HTTPAPI › Événements › OnAsynchronous

OnAsynchronous Événement

Se déclenche lorsqu'une opération d'envoi asynchrone lancée par le serveur API HTTP est terminée.

Syntaxe

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

Valeur par défaut

—

Remarques

Lorsque la propriété Asynchronous est True, les messages écrits vers un client ne bloquent pas le thread appelant : le worker IOCP met l'envoi en file d'attente et retourne immédiatement, et HTTP.SYS signale la complétion ultérieurement. OnAsynchronous est déclenché pour chaque opération asynchrone complétée afin que l'application puisse libérer ou réutiliser les tampons sous-jacents. Le paramètre aConnection pointe vers le TsgcHTTPAPIContext associé à la requête complétée ; définissez Handled à True lorsque l'application a déjà supprimé le contexte pour empêcher le composant d'exécuter son nettoyage par défaut. Si Asynchronous est False (la valeur par défaut), cet événement n'est jamais déclenché.

Exemple

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

Retour aux événements