array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.com-message-pump.php', 1 => 'com_message_pump', 2 => 'Procesa un mensaje COM en un tiempo dado', ), 'up' => array ( 0 => 'ref.com.php', 1 => 'Funciones COM y .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' => 'es', '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 — Procesa un mensaje COM en un tiempo dado

Descripción

com_message_pump(int $timeout_milliseconds = 0): bool

Procesa un mensaje COM esperando hasta timeout_milliseconds milisegundos, o bien esperando a que un mensaje llegue a la cola.

El propósito de esta función es enrutar las llamadas COM entre los elementos y gestionar las diferentes sincronizaciones. Esto permite que el script espere eficientemente los eventos a desencadenar, mientras gestiona otros eventos o ejecuta otros scripts en segundo plano. Debe ser utilizada en un bucle, como en el ejemplo de la función com_event_sink(), hasta que se haya terminado de utilizar los objetos COM relacionados con eventos.

Parámetros

timeout_milliseconds

El tiempo de espera, en milisegundos.

Si no se especifica un valor para el parámetro timeout_milliseconds, entonces será 0. Un valor de 0 significa que los mensajes serán procesados inmediatamente; si hay mensajes en la cola, serán distribuidos de inmediato; si no hay mensajes en la cola, la función devolverá false inmediatamente sin esperar.

Valores devueltos

Si uno o más mensajes llegan antes de que expire el tiempo de espera, serán distribuidos y la función devolverá true. Si el tiempo de espera expira y no se procesa ningún mensaje, el valor devuelto será false.