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

Статья
08/26/2023

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

Функция TSPI_lineConfigDialog заставляет поставщика указанного устройства линии отображать модальное диалоговое окно в качестве дочернего окна hwndOwner , чтобы разрешить пользователю настраивать параметры, связанные с устройством линии.

Синтаксис

LONG TSPIAPI TSPI_lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Параметры

dwDeviceID

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

hwndOwner

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

lpszDeviceClass

Указатель на строку Юникода, завершающуюся null, идентифицирующее имя класса устройства. Этот класс устройства позволяет вызывающей объекту выбрать определенный подэкран сведений о конфигурации, применимых к этому классу устройства. Если этот параметр имеет значение NULL или пустую строку, необходимо выбрать диалоговое окно конфигурации верхнего уровня. Допустимые строки совпадают с TSPI_lineGetID. Например, если строка поддерживает API Comm, передача comm/datamodem как lpszDeviceClass приводит к тому, что поставщик отображает параметры, связанные с Comm (или, по крайней мере, начинается с соответствующей точки в цепочке диалоговых окон многоуровневой конфигурации, чтобы пользователю не нужно было искать нужные параметры).)

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

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

LINEERR_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL.

Процедура должна обновить раздел [Телефония Windows] в файле Win.ini и транслировать сообщение WM_WININICHANGE, если она вносит какие-либо изменения в файл Telephon.ini, которые могут привести к изменению возможностей строки или адреса, указанных в LINEDEVCAPS или LINEADDRESSCAPS, или если устройство линии создано или удалено.

Нет никаких ограничений на то, что эта функция (TSPI_lineConfigDialog) будет вызываться только при закрытии строки. Однако каждый поставщик может ввести такое ограничение самостоятельно. При вызове TSPI_lineConfigDialog поставщик может предупредить пользователя с сообщением "Строка используется одним или несколькими приложениями. Вы не можете изменить конфигурацию строки, пока она используется" (и вернуть сообщение об ошибке LINEERR_INUSE). Однако некоторые конфигурации могут быть безопасными при изменении "на лету", особенно тех, которые относятся к типам носителей (например, протоколу управления ошибками модема), особенно если этот тип мультимедиа в настоящее время не используется. Поставщик может разрешить изменение этих параметров во время открытия строки.

Пользователям не следует разрешать изменять значения, возвращаемые с помощью LINEDEVCAPS или LINEADDRESSCAPS , без принудительного закрытия строки в качестве сигнала о том, что приложения должны вызывать функции, возвращающие эти структуры, для получения точной информации.