Manuel PHP
Précédent |  | Suivant

# com_message_pump

(PHP 4 >= 4.2.3, PHP 5)

com_message_pump -- Traite un message COM en attendant jusqu'à timeoutms millisecondes

## Description

bool com_message_pump ( [int timeoutms] )

com_message_pump() traite un message COM en attendant jusqu'à `timeoutms` millisecondes, ou bien en attendant qu'un message arrive dans la file d'attente. Si un ou plusieurs messages arrivent avant le timeout, ils seront dispatchés et la fonction retournera `TRUE`. Si le timeout survient et qu'aucun message n'est traité, la valeur retournée sera `FALSE`. Si vous ne spécifiez pas de valeur pour le paramètre `timeoutms`, alors il voudra 0. 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 dispatchés aussitôt ; s'il n'y a aucun message dans la file d'attente, la fonction retournera `FALSE` immédiatement sans attendre.

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 à votre 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. Vous devriez l'utiliser dan une boucle, comme dans l'exemple de la fonction com_event_sink(), jusqu'à ce que vous ayez fini d'utiliser les objets COM liés à des événements.

Précédent | Sommaire | Suivant
com_load | Niveau supérieur | com_print_typeinfo