функция lineAddProviderA (tapi.h)

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

Синтаксис

LONG lineAddProviderA(
  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 или в другом месте пути).

Заметка

Заголовок tapi.h определяет lineAddProvider как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

LINE_CREATE

LINE_LINEDEVSTATE

PHONE_CREATE

дополнительных функций службы

Обзор TAPI 2.2

lineInitialize

lineInitializeEx