Функция lineConfigDialog (tapi.h)
Функция lineConfigDialog заставляет поставщика указанного линейного устройства отображать диалоговое окно (подключенное к hwndOwner приложения), чтобы разрешить пользователю настраивать параметры, связанные с устройством линии.
Синтаксис
LONG lineConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Параметры
dwDeviceID
Идентификатор настраиваемого линейного устройства.
hwndOwner
Дескриптор к окну, к которому будет присоединено диалоговое окно. Может иметь значение NULL , чтобы указать, что любое окно, созданное во время выполнения функции, не должно иметь окна-владельца.
lpszDeviceClass
Указатель на строку, завершающуюся значением NULL, которая идентифицирует имя класса устройства. Этот класс устройства позволяет приложению выбрать определенный подэкран сведений о конфигурации, применимых к этому классу устройства. Этот параметр является необязательным и может оставить значение NULL или пустой. В этом случае выбрана конфигурация самого высокого уровня.
Возвращаемое значение
Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPARAM, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL LINEERR_NODEVICE.
Комментарии
Функция lineConfigDialog заставляет поставщика услуг отображать модальное диалоговое окно (присоединенное к hwndOwner приложения), чтобы разрешить пользователю настраивать параметры, связанные со строкой, заданной dwDeviceID. Параметр lpszDeviceClass позволяет приложению выбрать определенный подэкран сведений о конфигурации, применимый к классу устройства, в котором заинтересован пользователь; допустимые строки совпадают с строкой lineGetID. Например, если строка поддерживает API Comm, передача "COMM" как lpszDeviceClass приводит к тому, что поставщик отображает параметры, связанные с Comm (или, по крайней мере, начинается с соответствующей точки в цепочке диалоговых окон многоуровневой конфигурации, поэтому пользователю не нужно "копать", чтобы найти интересующие параметры).
Параметр lpszDeviceClass будет иметь значение "tapi/line", "" или NULL , чтобы поставщик отображал конфигурацию самого высокого уровня для строки.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |