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 ; si il y a des messages dans la file d'attente, ils seront dispatchés aussitôt ; si il n'y a aucun message dans la file d'attente, la foncton 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