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

Статья
08/26/2023

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

Функция TUISPI_providerConfig собирает сведения о конфигурации пользователя. Он может использовать диалоговое окно, и это диалоговое окно может включать вложенные диалоговые окна, связанные с другими API (например, Comm/datamodem) для настройки конкретных устройств.

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

Синтаксис

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

Параметры

lpfnUIDLLCallback

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

hwndOwner

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

dwPermanentProviderID

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

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

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

LINEERR_OPERATIONFAILED, LINEERR_NOMEM.

Непосредственно соответствующей функции на уровне TAPI нет. В TAPI приложения имеют доступ к функциям lineConfigDialog и phoneConfigDialog, которые позволяют настраивать параметры определенной линии или телефона после установки.