Metodo ITPhone::get_ButtonMode (tapi3if.h)

Il metodo get_ButtonMode recupera la modalità pulsante associata a un pulsante specifico.

L'applicazione deve chiamare ITPhone::Open prima di richiamare questo metodo; in caso contrario, la chiamata ha esito negativo.

Sintassi

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

[in] lButtonID

Identificatore del pulsante. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[out] pButtonMode

Descrittore PHONE_BUTTON_MODE per la modalità del pulsante.

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Vedere la descrizione dell'enumerazione PHONE_BUTTON_MODE e del TAPI 2. x documentazione per altre informazioni sulle modalità dei pulsanti.

I due valori di PHONE_BUTTON_MODE seguenti sono di particolare interesse:

Se il valore PHONE_BUTTON_MODE è PBM_FEATURE, l'applicazione deve chiamare il get_ButtonFunction per recuperare il significato specifico del pulsante.
Se il valore PHONE_BUTTON_MODE è PBM_KEYPAD, il pulsante è un pulsante del tastierino il cui valore è indicato dal valore del parametro lButtonID . Ad esempio, se lButtonID == 10, il pulsante è il tasto * (star) sul tastierino.