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

Статья
08/26/2023

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

Синтаксис

LONG lineAddProvider(
  LPCSTR  lpszProviderFilename,
  HWND    hwndOwner,
  LPDWORD lpdwPermanentProviderID
);

Параметры

lpszProviderFilename

Указатель на

Строка, завершающаяся null, содержащая путь к добавляемого поставщика услуг.

hwndOwner

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

lpdwPermanentProviderID

Указатель на переменную, которая получает постоянный идентификатор только что установленного поставщика услуг.

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

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

LINEERR_INIFILECORRUPT, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOMULTIPLEINSTANCE LINEERR_OPERATIONFAILED.

Во время вызова функции TAPI проверяет, может ли он получить доступ к поставщику услуг путем вызова функции TSPI_providerInstall ; Если это не удалось (если не удается найти библиотеку DLL или функцию или если TSPI_providerInstall возвращает ошибку), функция завершается ошибкой, и поставщик не добавляется в систему телефонии. Если это успешно и система телефонии активна (одно или несколько приложений вызвали lineInitialize или lineInitializeEx), TAPI не пытается запустить только что добавленного поставщика услуг. Вместо этого, чтобы активировать нового поставщика услуг, TAPI выдает сообщение о перезапуске Windows. После успешной активации приложения получают сведения о новых устройствах, созданных с помощью сообщений LINE_CREATE или PHONE_CREATE , или с помощью LINE_LINEDEVSTATE сообщения с запросом повторной инициализации (если приложение не поддерживает сообщения CREATE).

Эта функция не копирует ни файлы, ни саму библиотеку DLL поставщика услуг, ни вспомогательные файлы; приложение, управляющее добавлением поставщика, должно убедиться, что поставщик установлен в каталоге, где его можно найти с помощью TAPI (например, \WINDOWS, \WINDOWS\SYSTEM или в другом месте пути).