LINE_REMOVE сообщение
Сообщение LINE_REMOVE TAPI отправляется для информирования приложения об удалении (удалении из системы) устройства с линией. Как правило, это не используется для временных удалений, таких как извлечение устройств PCMCIA, а только для постоянных удалений, в которых поставщик услуг больше не будет сообщать о устройстве, если tapi были повторно инициализированы.
-
hDevice
-
Зарезервировано. Задайте нулевое значение.
-
dwCallbackInstance
-
Зарезервировано. Задайте нулевое значение.
-
dwParam1
-
Идентификатор удаленного линейного устройства.
-
dwParam2
-
Зарезервировано. Задайте нулевое значение.
-
dwParam3
-
Зарезервировано. Задайте нулевое значение.
Нет возвращаемого значения.
Приложениям, поддерживающим TAPI версии 2.0 или более поздней, отправляется сообщение LINE_REMOVE . Это сообщает им о том, что устройство было удалено из системы. Сообщение LINE_REMOVE предваряется сообщением LINE_CLOSE на каждом дескрипторове строки, если в приложении открыта строка. Это сообщение отправляется всем приложениям, поддерживающим TAPI версии 2.0 или более поздней, которые вызвали lineInitializeEx, в том числе приложениям, в которых в то время не были открыты какие-либо линейные устройства.
Старым приложениям отправляется LINE_LINEDEVSTATE сообщение с указанием LINEDEVSTATE_REMOVED, за которым следует LINE_CLOSE сообщение. Однако в отличие от сообщения LINE_REMOVE , эти старые приложения могут получать эти сообщения только в том случае, если строка открыта при удалении. Если у них нет открытой строки, единственным признаком того, что устройство было удалено, будет сообщение об ошибке LINEERR_NODEVICE при попытке доступа к устройству.
После удаления устройства любая попытка получить к устройству доступ по его идентификатору устройства приводит к LINEERR_NODEVICE ошибке. После завершения работы всех приложений TAPI после перезапуска TAPI и повторной инициализации TAPI удаленное устройство больше не будет занимать идентификатор устройства.
Примечание
Реализация: именно TAPI возвращает этот LINEERR_NODEVICE; после получения сообщения LINE_REMOVE от поставщика услуг; никакие дальнейшие вызовы к поставщику услуг с использованием этого идентификатора устройства линии не выполняются.
Требование | Значение |
---|---|
Версия TAPI |
Требуется TAPI 2.0 или более поздней версии |
Заголовок |
|