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. Celà 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 aillez fini d'utiliser les objets COM liés à des évènements.

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