com_event_sink
En esta página
com_event_sink
Conecta eventos de un objeto COM a un objeto PHP
Descripción#
com_event_sink(variant $variant, object $sink_object, [array $sink_interface]): bool
```php
Conecta eventos del objeto COM `variant` a un objeto PHP `sink_object`.
Sea prudente al utilizar esta funcionalidad; si se hace algo similar al ejemplo a continuación, no tiene sentido ejecutarlo en un servidor web.
## Parámetros
`variant`
`sink_object`
`sink_object` debe ser una instancia de la clase con nombres de métodos que sigan el dispinterface deseado; se debe utilizar `com_print_typeinfo` para ayudar a generar una plantilla de clase para esto.
`sink_interface`
PHP debe ser capaz de utilizar el tipo por defecto de dispinterface especificado por la Typelib asociada con el objeto `variant`, pero se puede cambiar esto especificando en el parámetro `sink_interface` el dispinterface que se desea utilizar.
## Valores devueltos
Esta función retorna `true` en caso de éxito o `false` si ocurre un error.
## Historial de cambios
| Versión | Descripción |
|---------|-------------------------------------|
| 8.0.0 | `sink_interface` ahora es nullable. |
## Ejemplos
Ejemplo de conexiones de eventos COM
```php
Notas#
[!CAUTION] Antes de PHP 8.0.0, llamar a
exitdesde cualquier gestor de eventos no es soportado, y puede causar que PHP se bloquee. Esto puede evitarse lanzando una excepción desde un gestor de eventos, capturando la excepción en el código principal, y llamando aexitallí.
Véase también#
com_print_typeinfo, com_message_pump