com_event_sink

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

com_event_sink — Зв'язати повідомлення COM з об'єктом PHP

Опис

com_event_sink(variant $variant, object $sink_object, array|string|null $sink_interface = null): bool

Зобов'язує об'єкт COM прокидати повідомлення, створені variant в об'єкт PHP sink_object

Будьте обережні з цією можливістю. Якщо ви робитимете щось схоже на приклад нижче, то це не матиме жодного сенсу під час запуску в контексті веб-сервера.

Список параметрів

variant

sink_object

sink_object повинен бути екземпляром класу з методами, названими як у вибраному диспетчерському інтерфейсі; ви можете використовувати функцію com_print_typeinfo()для помощи в генерации шаблона класса.

sink_interface

PHP намагатиметься використовувати тип диспетчерського інтерфейсу за промовчанням, як зазначено в бібліотеці типів, пов'язаної з variant, але ви можете змінити таку поведінку, поставивши в sink_interface ім'я бажаного диспетчерського інтерфейсу.

Значення, що повертаються

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

список змін

Версия	Опис
8.0.0	sink_interface тепер допускає значення null.

Приклади

Приклад #1 Приклад com_event_sink

Loading...
▶

Примітки

Застереження

До PHP 8.0.0 виклик exit() з будь-якого оброблювача події не підтримувався і міг призвести до зависання PHP. Це можна обійти, викидаючи виняток із обробника події, перехоплюючи виняток в основному коді та викликаючи звідти exit()

Дивіться також

• com_print_typeinfo() - Друкує визначення класу PHP для інтерфейсу, що наслідує IDispatch
• com_message_pump() - Обробка повідомлень COM, що прийшли не пізніше timeoutms мілісекунд після її запуску