PHONEBUTTONFUNCTION

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

These scalar constants describe the functions commonly assigned to buttons on telephone sets.

The following table shows the PHONEBUTTONFUNCTION constants.

Value	Description
PHONEBUTTONFUNCTION_ABBREVDIAL = 0x0000000B	The number to be dialed will be indicated using a short, abbreviated number consisting of one digit or a few digits.
PHONEBUTTONFUNCTION_BUSY = 0x0000001D	Makes the phone appear "busy" to incoming calls.
PHONEBUTTONFUNCTION_BRIDGEDAPP = 0x0000001C	Selects a particular appearance of a bridged address.
PHONEBUTTONFUNCTION_CALLAPP = 0x0000001E	Selects a particular call appearance.
PHONEBUTTONFUNCTION_CALLID = 0x00000022	Requests display of caller ID on the phone's display.
PHONEBUTTONFUNCTION_CAMPON = 0x0000002B	Camps-on an extension that returns a busy indication. When the remote station returns to idle, the phone will be rung with a distinctive pattern. Picking up the local phone reinitiates the call.
PHONEBUTTONFUNCTION_COVER = 0x00000021	Forwards all calls destined for this phone to another phone used for coverage.
PHONEBUTTONFUNCTION_CONFERENCE = 0x00000001	Initiates a conference call or adds a call to a conference call.
PHONEBUTTONFUNCTION_CONNECT = 0x00000007	Reconnects a call that is on consultation hold.
PHONEBUTTONFUNCTION_DATAOFF = 0x00000019	Indicates that the next call is not a data call.
PHONEBUTTONFUNCTION_DATAON = 0x00000018	Indicates that the next call is a data call.
PHONEBUTTONFUNCTION_DATETIME = 0x0000001F	Causes the phone to display current date and time; this information would be sent by the switch.
PHONEBUTTONFUNCTION_DIRECTORY = 0x00000020	Calls up directory service from the switch.
PHONEBUTTONFUNCTION_DISCONNECT = 0x00000006	Disconnects a call, such as after initiating a transfer.
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_DROP = 0x00000003	Drops the active call.
PHONEBUTTONFUNCTION_FLASH = 0x00000017	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 = 0x0000000C	Initiates or changes call forwarding to this phone.
PHONEBUTTONFUNCTION_HOLD = 0x00000004	Places the active call on hold.
PHONEBUTTONFUNCTION_INTERCOM = 0x0000001B	Connects to the intercom to broadcast a page.
PHONEBUTTONFUNCTION_LASTNUM = 0x00000023	Redials last number dialed.
PHONEBUTTONFUNCTION_MSGINDICATOR = 0x00000026	Controls the message indicator lamp.
PHONEBUTTONFUNCTION_MSGWAITOFF = 0x00000009	Turns off a message waiting lamp.
PHONEBUTTONFUNCTION_MSGWAITON = 0x00000008	Turns on a message waiting lamp.
PHONEBUTTONFUNCTION_MUTE = 0x00000012	Mutes the phone's microphone device.
PHONEBUTTONFUNCTION_NIGHTSRV = 0x00000024	Places the phone in the mode it is configured for during night hours.
PHONEBUTTONFUNCTION_NONE = 0x0000002E	A "dummy" function assignment that indicates that the button does not have a function.
PHONEBUTTONFUNCTION_PARK = 0x0000000F	Parks the active call on another phone, placing it on hold there.
PHONEBUTTONFUNCTION_PICKUP = 0x0000000D	Picks up a call ringing on another phone.
PHONEBUTTONFUNCTION_QUEUECALL = 0x0000002D	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 = 0x00000005	Unholds a call.
PHONEBUTTONFUNCTION_REDIRECT = 0x00000011	Redirects an incoming call to another extension before the call has been answered.
PHONEBUTTONFUNCTION_REJECT = 0x00000010	Rejects an incoming call before the call has been answered.
PHONEBUTTONFUNCTION_REPDIAL = 0x00000027	Repertory dialing — the number to be dialed is provided as a shorthand following pressing of this button.
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_SAVEREPEAT = 0x0000002C	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 = 0x0000000A	Allows the user to select the ring pattern of the phone.
PHONEBUTTONFUNCTION_SETREPDIAL = 0x00000028	Programs the shorthand-to-phone number mappings accessible by means of repertory dialing, the "REPDIAL" button.
PHONEBUTTONFUNCTION_SENDCALLS = 0x00000025	Sends all calls to another phone used for coverage. This is the same as PHONEBUTTONFUNCTION_COVER.
PHONEBUTTONFUNCTION_SPEAKEROFF = 0x00000016	Turns the phone's external speaker off.
PHONEBUTTONFUNCTION_SPEAKERON = 0x00000015	Turns the phone's external speaker on.
PHONEBUTTONFUNCTION_STATIONSPEED = 0x0000002A	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 = 0x00000029	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 = 0x00000002	Initiates a call transfer or completes the transfer of a call.
PHONEBUTTONFUNCTION_UNKNOWN = 0x00000000	A "dummy" function assignment that indicates that the exact function of the button is unknown or has not been assigned.
PHONEBUTTONFUNCTION_VOLUMEDOWN = 0x00000014	Decreases the volume of audio through the phone's handset speaker or speakerphone.
PHONEBUTTONFUNCTION_VOLUMEUP = 0x00000013	Increases the volume of audio through the phone's handset speaker or speakerphone.

Note

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.