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

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

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

Синтаксис

LONG TSPIAPI TSPI_providerConfig(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

Параметры

hwndOwner

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

dwPermanentProviderID

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

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

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

LINEERR_OPERATIONFAILED, LINEERR_NOMEM.

Комментарии

Эту функцию можно вызывать, когда используется поставщик услуг (то есть между вызовами TSPI_providerInit и TSPI_providerShutdown).

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

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

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

Требования

Требование	Значение
Целевая платформа	Windows
Header	tspi.h

См. также раздел

TSPI_lineConfigDialog

TSPI_phoneConfigDialog

TSPI_providerInstall

TSPI_providerRemove

TUISPI_providerConfig