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

Статья
03/03/2024

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

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

Синтаксис

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

Параметры

lpfnUIDLLCallback

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

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.

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

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