Функция lineConfigDialogA (tapi.h)

Статья
08/26/2023

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

Синтаксис

LONG lineConfigDialogA(
  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 , чтобы поставщик отображал конфигурацию самого высокого уровня для строки.

Примечание

Заголовок tapi.h определяет lineConfigDialog как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.