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

Статья
08/26/2023

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

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

Синтаксис

LONG TSPIAPI TUISPI_phoneConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

Параметры

lpfnUIDLLCallback

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

dwDeviceID

Настраиваемая телефонная система.

hwndOwner

Дескриптор родительского окна, в котором должно быть помещено диалоговое окно.

lpszDeviceClass

Указатель на строку Юникода, завершающуюся null, идентифицирующее имя класса устройства. Этот класс устройства позволяет вызывающей объекту выбрать определенный подэкран сведений о конфигурации, применимых к этому классу устройства. Если этот параметр имеет значение NULL или пустую строку, выбирается диалоговое окно конфигурации верхнего уровня.

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

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

PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS PHONEERR_RESOURCEUNAVAIL.

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

Например, если телефон поддерживает API Comm, передача comm/datamodem как lpszDeviceClass приводит к тому, что поставщик отображает параметры, связанные с Comm (или, по крайней мере, начинается с соответствующей точки в цепочке диалоговых окон многоуровневой конфигурации, чтобы пользователю не нужно было искать нужные параметры). Параметр szDeviceClass должен иметь значение "tapi/phone", "" или NULL , чтобы поставщик отображал конфигурацию самого высокого уровня для телефона.

Требования

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

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

PHONECAPS

TSPI_phoneGetID

Поделиться через