функция TSPI_providerInstall (tspi.h)

Статья
03/03/2024

Функция TSPI_providerInstall устарела. Поставщики услуг TAPI версии 1.4 или более ранней могут реализовать эту функцию TSPI. TSP TAPI версии 2.0 или более поздней реализуют TUISPI_providerInstall.

Функция TSPI_providerInstall устанавливает все дополнительные "части" поставщика в нужные каталоги (или по крайней мере проверяет их наличие), настраивает записи реестра поставщика для его строк и телефонов и создает все другие записи, необходимые поставщику услуг. Он вызывается из служебной программы панель управления телефонии (поставляемой вместе с Телефонией Windows в версиях 1.4 и более ранних версиях) при нажатии кнопки Добавить.

Синтаксис

LONG TSPIAPI TSPI_providerInstall(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

Параметры

hwndOwner

Дескриптор родительского окна, в котором функция может создавать любые диалоговые окна, необходимые во время установки.

dwPermanentProviderID

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

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

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

LINEERR_OPERATIONFAILED, LINEERR_INIFILECORRUPT, LINEERR_NOMEM LINEERR_INVALPARAM.

Эта функция завершает установку других компонентов, необходимых поставщику услуг, после внесения записей в раздел [Поставщики] в реестре. Если поставщик услуг требует каких-либо дополнительных частных записей в реестре для правильной работы, они также должны быть установлены. Типичным способом установки этого раздела с его записями является вызов TSPI_providerConfig.

Эта функция должна оставить систему в согласованном состоянии. Он должен выполняться до завершения, не позволяя пользователю прервать установку, когда она будет частично завершена. Если установка завершается сбоем, поставщик несет ответственность за то, что было сделано, и возвратить ошибку. Это может означать предварительную проверку, чтобы убедиться, что полная установка возможна до начала установки.

Эта функция вызывается только один раз во время установки поставщика услуг, пока не будет выполнен вызов TSPI_providerRemove. Он должен вызываться перед любой другой функцией, определяемой TSPI.

Служебная программа панель управления телефонии, поставляемая с телефонией Windows в версиях 1.4 и более ранних версиях, вызывает эту функцию (с требованиями к внешней последовательности, как описано здесь) при вызове команды add. Он не вызывает TSPI_providerConfig для команды "добавить".

Соответствующая функция на уровне TAPI отсутствует. На этом уровне приложения ожидают, что поставщики услуг уже установлены. Работающие приложения информируются о динамической перенастройке с помощью LINEDEVSTATE_REINIT или PHONESTATE_REINIT значения в сообщении LINE_LINEDEVSTATE или PHONE_STATE.