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

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


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

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

LINE_CLOSE

LINE_LINEDEVSTATE

lineInitializeEx