Método ITPhone::get_ButtonMode (tapi3if.h)

El método get_ButtonMode recupera el modo de botón asociado a un botón determinado.

La aplicación debe llamar a ITPhone::Open antes de invocar este método; de lo contrario, se produce un error en la invocación.

Sintaxis

HRESULT get_ButtonMode(
  [in]  long              lButtonID,
  [out] PHONE_BUTTON_MODE *pButtonMode
);

[in] lButtonID

Identificador de botón. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[out] pButtonMode

Descriptor de PHONE_BUTTON_MODE para el modo del botón.

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Consulte la descripción de la enumeración PHONE_BUTTON_MODE y el TAPI 2. Documentación de x para obtener más información sobre los modos de botón.

Los dos valores de PHONE_BUTTON_MODE siguientes son de especial interés:

Si el valor de PHONE_BUTTON_MODE es PBM_FEATURE, la aplicación debe llamar al get_ButtonFunction para recuperar el significado específico del botón.
Si el valor PHONE_BUTTON_MODE es PBM_KEYPAD, el botón es un botón del teclado cuyo valor se indica mediante el valor del parámetro lButtonID . Por ejemplo, si lButtonID == 10, el botón es la tecla * (star) del teclado.