функция TSPI_phoneConfigDialog (tspi.h)
Функция TSPI_phoneConfigDialog устарела. Поставщики служб TAPI версии 1.4 или более ранних версий могут реализовать эту функцию TSPI. TAPI версии 2.0 или более поздней TSP реализуют TUISPI_phoneConfigDialog.
Функция TSPI_phoneConfigDialog приводит к тому, что поставщик указанного телефонного устройства отображает модальное диалоговое окно в качестве дочернего окна hwndOwner, чтобы разрешить пользователю настраивать параметры, связанные с телефонным устройством.
Синтаксис
LONG TSPIAPI TSPI_phoneConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Параметры
dwDeviceID
Настраиваемая телефонная система.
hwndOwner
Дескриптор родительского окна, в котором должно быть размещено диалоговое окно.
lpszDeviceClass
Указатель на строку Юникода, завершающуюся значением NULL, которая идентифицирует имя класса устройства. Этот класс устройства позволяет вызывающей стороны выбрать определенный подэкран сведений о конфигурации, применимых к этому классу устройства. Если этот параметр имеет значение NULL или пустую строку, выбирается диалоговое окно конфигурации самого высокого уровня.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS PHONEERR_RESOURCEUNAVAIL.
Комментарии
TSPI_phoneConfigDialog поставщик услуг отображает модальное диалоговое окно в качестве дочернего окна hWndOwner , чтобы разрешить пользователю настраивать параметры, связанные с телефоном, указанным dwDeviceID. Параметр lpszDeviceClass позволяет приложению выбрать определенный подэкран сведений о конфигурации, применимый к классу устройства, в котором заинтересован пользователь. Допустимые строки такие же, как и для TSPI_phoneGetID. Например, если телефон поддерживает API Comm, передача comm/datamodem как lpszDeviceClass приводит к тому, что поставщик отображает параметры, связанные с Comm (или, по крайней мере, начинается в соответствующей точке цепочки диалоговых окон многоуровневой конфигурации, чтобы пользователю не нужно было искать нужные параметры). Параметр szDeviceClass должен иметь значение "tapi/phone", "" или NULL , чтобы поставщик отображал конфигурацию самого высокого уровня для телефона.
Процедура должна обновить раздел [Телефония Windows] в файле Win.ini и транслировать сообщение WM_WININICHANGE, если она вносит какие-либо изменения в Telephon.ini, влияющие на содержимое структур, видимых для приложений (например , PHONECAPS), или если телефонные устройства созданы или удалены.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |