PHONEBUTTONFUNCTION_ Constants
The PHONEBUTTONFUNCTION_ scalar constants describe the functions commonly assigned to buttons on telephone sets.
- PHONEBUTTONFUNCTION_ABBREVDIAL
- The number to be dialed will be indicated using a short, abbreviated number consisting of one digit or a few digits.
- PHONEBUTTONFUNCTION_BUSY
- Makes the phone appear "busy" to incoming calls.
- PHONEBUTTONFUNCTION_BRIDGEDAPP
- Selects a particular appearance of a bridged address.
- PHONEBUTTONFUNCTION_CALLAPP
- Selects a particular call appearance.
- PHONEBUTTONFUNCTION_CALLID
- Requests display of caller ID on the phone's display.
- PHONEBUTTONFUNCTION_CAMPON
- Camps-on an extension that returns a busy indication. When the remote station returns to idle, the phone will be rung with a distinctive patterns. Picking up the local phone reinitiates the call.
- PHONEBUTTONFUNCTION_COVER
- Forwards all calls destined for this phone to another phone used for coverage.
- PHONEBUTTONFUNCTION_CONFERENCE
- Initiates a conference call or adds a call to a conference call.
- PHONEBUTTONFUNCTION_CONNECT
- Reconnects a call that is on consultation hold.
- PHONEBUTTONFUNCTION_DATAOFF
- Indicates that the next call is not a data call.
- PHONEBUTTONFUNCTION_DATAON
- Indicates that the next call is a data call.
- PHONEBUTTONFUNCTION_DATETIME
- Causes the phone to display current date and time; this information would be sent by the switch.
- PHONEBUTTONFUNCTION_DIRECTORY
- Calls up directory service from the switch.
- PHONEBUTTONFUNCTION_DISCONNECT
- Disconnects a call, such as after initiating a transfer.
- PHONEBUTTONFUNCTION_DONOTDISTURB
- Places the phone in "do not disturb" mode; incoming calls receive a busy signal or are forwarded to an operator or voice mail system.
- PHONEBUTTONFUNCTION_DROP
- Drops the active call.
- PHONEBUTTONFUNCTION_FLASH
- Generates the equivalent of an onhook/offhook sequence. A flash typically indicates that any digits typed next are to be understood as commands to the switch. On many switches, places an active call on consultation hold.
- PHONEBUTTONFUNCTION_FORWARD
- Initiates or changes call forwarding to this phone.
- PHONEBUTTONFUNCTION_HOLD
- Places the active call on hold.
- PHONEBUTTONFUNCTION_INTERCOM
- Connects to the intercom to broadcast a page.
- PHONEBUTTONFUNCTION_LASTNUM
- Redials last number dialed.
- PHONEBUTTONFUNCTION_MSGINDICATOR
- Controls the message indicator lamp.
- PHONEBUTTONFUNCTION_MSGWAITOFF
- Turns off a message waiting lamp.
- PHONEBUTTONFUNCTION_MSGWAITON
- Turns on a message waiting lamp.
- PHONEBUTTONFUNCTION_MUTE
- Mutes the phone's microphone device.
- PHONEBUTTONFUNCTION_NIGHTSRV
- Places the phone in the mode it is configured for during night hours.
- PHONEBUTTONFUNCTION_NONE
- A "dummy" function assignment that indicates that the button does not have a function.
- PHONEBUTTONFUNCTION_PARK
- Parks the active call on another phone, placing it on hold there.
- PHONEBUTTONFUNCTION_PICKUP
- Picks up a call ringing on another phone.
- PHONEBUTTONFUNCTION_QUEUECALL
- Queues a call to an outside number after it encounters a trunk-busy indication. When a trunk becomes later available, the phone will be rung with a distinctive pattern. Picking up the local phone reinitiates the call.
- PHONEBUTTONFUNCTION_RECALL
- Unholds a call.
- PHONEBUTTONFUNCTION_REDIRECT
- Redirects an incoming call to another extension before the call has been answered.
- PHONEBUTTONFUNCTION_REJECT
- Rejects an incoming call before the call has been answered.
- PHONEBUTTONFUNCTION_REPDIAL
- Repertory dialing—the number to be dialed is provided as a shorthand following pressing of this button.
- PHONEBUTTONFUNCTION_RINGAGAIN
- Initiates a request to be notified if a call cannot be completed normally because of a busy signal or no answer.
- PHONEBUTTONFUNCTION_SAVEREPEAT
- When pressed while a call or call attempt is active, it will remember that call's number or command. When pressed while no call is active (such as during dial tone), it repeats the most saved command.
- PHONEBUTTONFUNCTION_SELECTRING
- Allows the user to select the ring pattern of the phone.
- PHONEBUTTONFUNCTION_SETREPDIAL
- Programs the shorthand-to-phone number mappings accessible by means of repertory dialing (the "REPDIAL" button).
- PHONEBUTTONFUNCTION_SENDCALLS
- Sends all calls to another phone used for coverage; same as PHONEBUTTONFUNCTION_COVER.
- PHONEBUTTONFUNCTION_SPEAKEROFF
- Turns the phone's external speaker off.
- PHONEBUTTONFUNCTION_SPEAKERON
- Turns the phone's external speaker on.
- PHONEBUTTONFUNCTION_STATIONSPEED
- The number to be dialed is provided as a shorthand following pressing of this button. The mappings for station speed dialing are specific to this station (phone).
- PHONEBUTTONFUNCTION_SYSTEMSPEED
- The number to be dialed is provided as a shorthand following pressing of this button. The mappings for system speed dialing are configured inside the switch.
- PHONEBUTTONFUNCTION_TRANSFER
- Initiates a call transfer or completes the transfer of a call.
- PHONEBUTTONFUNCTION_UNKNOWN
- A "dummy" function assignment that indicates that the exact function of the button is unknown or has not been assigned.
- PHONEBUTTONFUNCTION_VOLUMEDOWN
- Decreases the volume of audio through the phone's handset speaker or speakerphone.
- PHONEBUTTONFUNCTION_VOLUMEUP
- Increases the volume of audio through the phone's handset speaker or speakerphone.
Values in the range 0x80000000 to 0xFFFFFFFF can be assigned for device-specific extensions; values in the range 0x00000000 to 0x7FFFFFFF are reserved.
The PHONEBUTTONFUNCTION_ constants have values commonly found on current telephone sets. These button functions can be used to invoke the corresponding function from the switch using lineDevSpecificFeature. Note that TAPI does not define the semantics of the button functions; it only provides access to the corresponding function. The behavior associated with each of the function values above is generic and can vary based on the telephony environment.
Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
Windows 95/98: Requires Windows 95 or later.
Version: Requires TAPI 2.0 or later.
Header: Declared in Tapi.h.