ITPhone::get_ButtonMode-Methode (tapi3if.h)

Die get_ButtonMode-Methode ruft den Schaltflächenmodus ab, der einer bestimmten Schaltfläche zugeordnet ist.

Die Anwendung muss ITPhone::Open aufrufen, bevor diese Methode aufgerufen wird. andernfalls schlägt der Aufruf fehl.

Syntax

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

Parameter

[in] lButtonID

Schaltflächenbezeichner. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[out] pButtonMode

Die PHONE_BUTTON_MODE Deskriptor für den Modus der Schaltfläche.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Sehen Sie sich die Beschreibung der PHONE_BUTTON_MODE-Enumeration und der TAPI 2 an. x-Dokumentation für weitere Informationen zu Schaltflächenmodi.

Von besonderem Interesse sind die beiden folgenden PHONE_BUTTON_MODE Werte:

1. Wenn der PHONE_BUTTON_MODE Wert PBM_FEATURE ist, sollte die Anwendung den get_ButtonFunction aufrufen, um die spezifische Bedeutung der Schaltfläche abzurufen.
2. Wenn der wert PHONE_BUTTON_MODE PBM_KEYPAD ist, handelt es sich bei der Schaltfläche um eine Tastenfeldschaltfläche, deren Wert durch den Wert des lButtonID-Parameters angegeben wird. Wenn beispielsweise lButtonID == 10 ist, ist die Schaltfläche die Taste * (star) auf der Tastatur.

Anforderungen

Weitere Informationen

ITPhone

get_ButtonFunction

put_ButtonMode