Прочитать на английском

Поделиться через


PHONE_REMOVE сообщение

Сообщение PHONE_REMOVE TAPI отправляется для информирования приложения об удалении (удалении из системы) телефонного устройства. Как правило, это не используется для временных удалений, таких как извлечение устройств PCMCIA, а только для постоянных удалений, в которых поставщик услуг больше не будет сообщать о устройстве, если tapi были повторно инициализированы.

            

Параметры

hDevice

Зарезервировано. Задайте нулевое значение.

dwCallbackInstance

Зарезервировано. Задайте нулевое значение.

dwParam1

Идентификатор удаленного телефонного устройства.

dwParam2

Зарезервировано. Задайте нулевое значение.

dwParam3

Зарезервировано. Задайте нулевое значение.

Возвращаемое значение

Нет возвращаемого значения.

Комментарии

Приложениям TAPI версии 2.0 или более поздней отправляется сообщение PHONE_REMOVE . Это сообщает им о том, что устройство было удалено из системы. Сообщение PHONE_REMOVE предшествует PHONE_CLOSE сообщение на каждом дескрипторове телефона, если приложение открыло телефон. Это сообщение отправляется всем приложениям, поддерживающим TAPI версии 2.0 или более поздней, которые вызвали phoneInitializeEx, в том числе приложениям, в которых в то время не были открыты телефонные устройства.

Старые приложения (которые согласовывали TAPI версии 1.4 или более ранней) отправляют PHONE_STATE сообщение с указанием PHONESTATE_REMOVED, за которым следует сообщение PHONE_CLOSE . Однако, в отличие от PHONE_REMOVE сообщения, эти старые приложения могут получать эти сообщения только в том случае, если телефон открыт при его удалении. Если телефон не открыт, единственным признаком того, что устройство было удалено, будет получать PHONEERR_NODEVICE при попытке доступа к устройству.

После удаления устройства любая попытка получить к устройству доступ по его идентификатору устройства приводит к PHONEERR_NODEVICE ошибке. После завершения работы всех приложений TAPI после перезапуска TAPI и повторной инициализации TAPI удаленное устройство больше не будет занимать идентификатор устройства.

Примечание

Реализация: именно TAPI возвращает это PHONEERR_NODEVICE сообщение после получения PHONE_REMOVE сообщения от поставщика услуг; никаких дальнейших вызовов к поставщику услуг с использованием этого идентификатора телефонного устройства.

Требования

Требование Значение
Версия TAPI
Требуется TAPI 2.0 или более поздней версии
Заголовок
Tapi.h

См. также раздел

PHONE_CLOSE

PHONE_STATE

phoneInitialize

phoneInitializeEx