Функция phoneConfigDialog (tapi.h)
Функция phoneConfigDialog приводит к тому, что поставщик указанного телефонного устройства отображает модальное диалоговое окно (подключенное к параметру hwndOwner приложения), которое позволяет пользователю настраивать параметры, связанные с телефонным устройством, указанным dwDeviceID.
Синтаксис
LONG phoneConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Параметры
dwDeviceID
Идентификатор настраиваемого телефонного устройства.
hwndOwner
Дескриптор к окну, к которому будет присоединено диалоговое окно. Может иметь значение NULL , указывающее, что любое окно, созданное во время выполнения функции, не должно иметь окна-владельца.
lpszDeviceClass
Указатель на строку, завершающуюся значением NULL, которая идентифицирует имя класса устройства. Этот класс устройства позволяет приложению выбрать определенный подэкран сведений о конфигурации, применимых к этому классу устройства. Этот параметр является необязательным и может оставить значение NULL или пустой. В этом случае выбрана конфигурация самого высокого уровня.
Возвращаемое значение
Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.
Комментарии
Параметр lpszDeviceClass позволяет приложению выбрать определенный подэкран сведений о конфигурации, применимый к классу устройства, в котором заинтересован пользователь; допустимые строки такие же, как и для phoneGetID. Например, если телефон поддерживает волновой API, передача "wave/in" как lpszDeviceClass приведет к тому, что поставщик отобразит параметры, связанные с волной (или, по крайней мере, начать в соответствующей точке в цепочке диалоговых окон многоуровневой конфигурации, устраняя необходимость поиска соответствующих параметров).
Параметр lpszDeviceClass должен иметь значение "tapi/phone", "" или NULL , чтобы поставщик отображал конфигурацию самого высокого уровня для телефона.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |