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

Статья
03/13/2024

Реализация функции TUISPI_providerInstall — это возможность поставщика услуг установить любые дополнительные "компоненты" поставщика в нужные каталоги (или, по крайней мере, убедиться, что они там) и настроить записи реестра, необходимые поставщику. Эта функция делает функцию TSPI_providerInstall устаревшей в версии 2.0 и более поздних (поддерживается в версии 1.4 и более ранних версиях).

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

Реализация является необязательной.

Синтаксис

LONG TSPIAPI TUISPI_providerInstall(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

Параметры

lpfnUIDLLCallback

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

hwndOwner

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

dwPermanentProviderID

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

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

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

LINEERR_OPERATIONFAILED, LINEERR_INIFILECORRUPT LINEERR_NOMEM. LINEERR_INVALPARAM.

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

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

Соответствующая функция на уровне TAPI — lineAddProvider. Сообщение LINE_CREATE уведомляет запущенные приложения о динамической перенастройки.