2.2.3.2.1 PHONEBUTTONFUNCTION_Constants

The PHONEBUTTONFUNCTION_Constants are scalar constants that describe the functions that are commonly assigned to buttons on telephone sets.

Constant/value	Description
PHONEBUTTONFUNCTION_UNKNOWN 0x00000000	A "dummy" function assignment that indicates that the exact function of the button is unknown or has not been assigned.
PHONEBUTTONFUNCTION_CONFERENCE 0x00000001	Initiates a conference call or adds a call to a conference call.
PHONEBUTTONFUNCTION_TRANSFER 0x00000002	Initiates a call transfer or completes the transfer of a call.
PHONEBUTTONFUNCTION_DROP 0x00000003	Drops the active call.
PHONEBUTTONFUNCTION_HOLD 0x00000004	Places the active call on hold.
PHONEBUTTONFUNCTION_RECALL 0x00000005	Unholds a call.
PHONEBUTTONFUNCTION_DISCONNECT 0x00000006	Disconnects a call, such as after initiating a transfer.
PHONEBUTTONFUNCTION_CONNECT 0x00000007	Reconnects a call that is on consultation hold.
PHONEBUTTONFUNCTION_MSGWAITON 0x00000008	Turns on a packet-waiting lamp.
PHONEBUTTONFUNCTION_MSGWAITOFF 0x00000009	Turns off a packet-waiting lamp.
PHONEBUTTONFUNCTION_SELECTRING 0x0000000A	Allows the user to select the ring pattern of the phone.
PHONEBUTTONFUNCTION_ABBREVDIAL 0x0000000B	Indicates the number to be dialed by using a short, abbreviated number that consists of one digit or a few digits.
PHONEBUTTONFUNCTION_FORWARD 0x0000000C	Initiates or changes call forwarding to this phone.
PHONEBUTTONFUNCTION_PICKUP 0x0000000D	Picks up a call ringing on another phone.
PHONEBUTTONFUNCTION_RINGAGAIN 0x0000000E	Initiates a request to be notified if a call cannot be completed normally because of a busy signal or no answer.
PHONEBUTTONFUNCTION_PARK 0x0000000F	Parks the active call on another phone, placing it on hold there.
PHONEBUTTONFUNCTION_REJECT 0x00000010	Rejects an incoming call before the call is answered.
PHONEBUTTONFUNCTION_REDIRECT 0x00000011	Redirects an incoming call to another extension before the call is answered.
PHONEBUTTONFUNCTION_MUTE 0x00000012	Mutes the microphone device on a phone.
PHONEBUTTONFUNCTION_VOLUMEUP 0x00000013	Increases the volume of audio through the handset speaker or speaker phone of the phone.
PHONEBUTTONFUNCTION_VOLUMEDOWN 0x00000014	Decreases the volume of audio through the handset speaker or speaker phone of the phone.
PHONEBUTTONFUNCTION_SPEAKERON 0x00000015	Turns on the external speaker of the phone.
PHONEBUTTONFUNCTION_SPEAKEROFF 0x00000016	Turns off the external speaker of the phone.
PHONEBUTTONFUNCTION_FLASH 0x00000017	Generates the equivalent of an on-the-hook/off-the-hook sequence. A flash typically indicates that any digits that are typed next are to be understood as commands to the switch. On many switches, places an active call on consultation hold.
PHONEBUTTONFUNCTION_DATAON 0x00000018	Indicates that the next call is a data call.
PHONEBUTTONFUNCTION_DATAOFF 0x00000019	Indicates that the next call is not a data call.
PHONEBUTTONFUNCTION_DONOTDISTURB 0x0000001A	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_INTERCOM 0x0000001B	Connects to the intercom to broadcast a page.
PHONEBUTTONFUNCTION_BRIDGEDAPP 0x0000001C	Selects a particular appearance of a bridged address.
PHONEBUTTONFUNCTION_BUSY 0x0000001D	Makes the phone appear busy to incoming calls.
PHONEBUTTONFUNCTION_CALLAPP 0x0000001E	Selects a particular call appearance.
PHONEBUTTONFUNCTION_DATETIME 0x0000001F	Causes the phone to display the current date and time; this information is sent by the switch.
PHONEBUTTONFUNCTION_DIRECTORY 0x00000020	Calls up directory service from the switch.
PHONEBUTTONFUNCTION_COVER 0x00000021	Forwards all calls that are destined for this phone to another phone that is used for coverage.
PHONEBUTTONFUNCTION_CALLID 0x00000022	Requests the display of caller ID on the phone display.
PHONEBUTTONFUNCTION_LASTNUM 0x00000023	Redials the last number that was dialed.
PHONEBUTTONFUNCTION_NIGHTSRV 0x00000024	Places the phone in the mode it is configured for during night hours.
PHONEBUTTONFUNCTION_SENDCALLS 0x00000025	Sends all calls to another phone that is used for coverage (same as PHONEBUTTONFUNCTION_COVER).
PHONEBUTTONFUNCTION_MSGINDICATOR 0x00000026	Controls the packet-indicator lamp.
PHONEBUTTONFUNCTION_REPDIAL 0x00000027	Provides repertory dialing of the number to be dialed as a shorthand following the pressing of this button.
PHONEBUTTONFUNCTION_SETREPDIAL 0x00000028	Programs the shorthand-to-phone number mappings that are accessible by means of repertory dialing (the REPDIAL button).
PHONEBUTTONFUNCTION_SYSTEMSPEED 0x00000029	Provides the number to be dialed as a shorthand following the pressing of this button. The mappings for telephony system speed dialing are configured inside the switch.
PHONEBUTTONFUNCTION_STATIONSPEED 0x0000002A	Provides the number to be dialed as a shorthand following the pressing of this button. The mappings for station speed dialing are specific to this station (phone).
PHONEBUTTONFUNCTION_CAMPON 0x0000002B	Camps-on an extension that returns a busy indication. When the remote station returns to idle, the phone is rung with a distinctive pattern. Picking up the local phone reinitiates the call.
PHONEBUTTONFUNCTION_SAVEREPEAT 0x0000002C	When pressed while a call or call attempt is active, remembers 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_QUEUECALL 0x0000002D	Queues a call to an outside number after it encounters a trunk-busy indication. When a trunk becomes available later, the phone rings with a distinctive pattern. Picking up the local phone reinitiates the call.
PHONEBUTTONFUNCTION_NONE 0x0000002E	A "dummy" function assignment that indicates that the button does not have a function.

The following constants are present in TAPI version 3.1.

Constant/value	Description
PHONEBUTTONFUNCTION_SEND 0x0000002F	Sends a request for a communications session.

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 that are commonly found on current telephone sets. TAPI does not define the semantics of the button functions; it only provides access to the corresponding function. The behavior that is associated with each of the preceding function values is generic and can vary based on the telephony environment.