Метод ITPhone::get_ButtonMode (tapi3if.h)
Метод get_ButtonMode извлекает режим кнопки, связанный с определенной кнопкой.
Приложение должно вызвать ITPhone::Open перед вызовом этого метода; в противном случае вызов завершается ошибкой.
Синтаксис
HRESULT get_ButtonMode(
[in] long lButtonID,
[out] PHONE_BUTTON_MODE *pButtonMode
);
Параметры
[in] lButtonID
Идентификатор кнопки. Дополнительные сведения см. в разделе "Примечания".
[out] pButtonMode
Дескриптор PHONE_BUTTON_MODE для режима кнопки.
Возвращаемое значение
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
См. описание перечисления PHONE_BUTTON_MODE и TAPI 2. Документация по x для получения дополнительных сведений о режимах кнопок.
Особый интерес представляют два следующих значения PHONE_BUTTON_MODE :
- Если значение PHONE_BUTTON_MODE равно PBM_FEATURE, приложение должно вызвать get_ButtonFunction , чтобы получить конкретное значение кнопки.
- Если значение PHONE_BUTTON_MODE равно PBM_KEYPAD, кнопка — это кнопка клавиатуры, значение которой указывается значением параметра lButtonID . Например, если lButtonID == 10, кнопка — это клавиша * (star) на клавиатуре.
Требования
| Целевая платформа | Windows |
| Header | tapi3if.h (включая Tapi3.h) |
| Библиотека | Uuid.lib |
| DLL | Tapi3.dll |