array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.com-message-pump.php', 1 => 'com_message_pump', 2 => 'Traite un message COM dans un délai donné', ), 'up' => array ( 0 => 'ref.com.php', 1 => 'Fonctions COM et .Net (Windows)', ), 'prev' => array ( 0 => 'function.com-load-typelib.php', 1 => 'com_load_typelib', ), 'next' => array ( 0 => 'function.com-print-typeinfo.php', 1 => 'com_print_typeinfo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/com/functions/com-message-pump.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

com_message_pump

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

com_message_pump — Traite un message COM dans un délai donné

Description

com_message_pump(int $timeout_milliseconds = 0): bool

Traite un message COM en attendant jusqu'à timeout_milliseconds millisecondes, ou bien en attendant qu'un message arrive dans la file d'attente.

Le but de cette fonction est d'acheminer les appels COM entre les éléments et de gérer les différentes synchronisations. Cela permet au script d'attendre efficacement les événements à déclencher, tout en gérant d'autres événements ou bien d'exécuter d'autres scripts en arrière-plan. Il est recommandé de l'utiliser dans une boucle, comme dans l'exemple de la fonction com_event_sink(), jusqu'à ce que l'on ait fini d'utiliser les objets COM liés à des événements.

Liste de paramètres

timeout_milliseconds

Le délai, en millisecondes.

Si l'on ne spécifie pas de valeur pour le paramètre timeout_milliseconds, alors la valeur 0 sera utilisée. Une valeur à 0 signifie que les messages seront traités immédiatement ; s'il y a des messages dans la file d'attente, ils seront distribués aussitôt ; s'il n'y a aucun message dans la file d'attente, la fonction retourne false immédiatement sans attendre.

Valeurs de retour

Si un ou plusieurs messages arrivent avant le délai d'expiration, ils seront distribués et la fonction retourne true. Si le délai d'expiration survient et qu'aucun message n'est traité, la valeur retournée sera false.