Функция lineRemoveProvider (tapi.h)

Статья
08/26/2023

Функция lineRemoveProvider удаляет существующего поставщика услуг телефонии из телефонной системы.

Синтаксис

LONG lineRemoveProvider(
  DWORD dwPermanentProviderID,
  HWND  hwndOwner
);

Параметры

dwPermanentProviderID

Постоянный идентификатор удаляемого поставщика услуг.

hwndOwner

Дескриптор к окну, к которому будут присоединены все диалоговые окна, которые должны отображаться в процессе удаления (например, диалоговое окно подтверждения с помощью функции TSPI_providerRemove поставщика услуг). Может иметь значение NULL , указывающее, что любое окно, созданное во время выполнения функции, не должно иметь окна-владельца.

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

Возвращает ноль, если запрос выполнен успешно, или отрицательный номер ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALPARAM LINEERR_OPERATIONFAILED.

Если звонок TSPI_providerRemove выполнен успешно, а система телефонии активна в это время, TAPI вызывает lineShutdown и (или ) phoneShutdown у поставщика услуг (в зависимости от типа устройств). Все дескрипторы линий или телефонов, которые по-прежнему хранятся в приложениях на связанных устройствах, принудительно закрываются с помощью LINE_CLOSE или PHONE_CLOSE сообщений (поставщики услуг предпочтительнее выдавать эти сообщения в рамках TSPI_providerRemove после проверки у пользователя). Устройства, ранее управляемые этим поставщиком, затем помечаются как недоступные, поэтому любые последующие попытки приложений ссылаться на них по идентификатору устройства приводят к LINEERR_NODRIVER.