функция TUISPI_providerConfig (tspi.h)
Функция 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.
Комментарии
Эта функция может вызываться при использовании поставщика услуг (то есть между вызовами TSPI_providerInit и TSPI_providerShutdown).
Любые изменения, влияющие на поведение, отображаемое через TSPI, должны вступают в силу только при перезапуске поставщика услуг в следующем TSPI_providerInit.
Непосредственно соответствующей функции на уровне TAPI нет. В TAPI приложения имеют доступ к функциям lineConfigDialog и phoneConfigDialog, которые позволяют настраивать параметры определенной линии или телефона после установки.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |