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 или более поздней версии |
Заголовок |
|