Partager via

PHONEBUTTONFUNCTION

  • Article

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.