Capabilities of the address. This property encapsulates the TAPI LINEADDRESSCAPS
structure. It's a set of sub-properties and each member holds a value
of the capablilities of the address. See Also the Microsoft TAPI documentation
of LINEADDRESSCAPS for a complete explanation.
The most often used members of the address caps are:
BusyModes (DWord)
Describes the various busy modes that can be reported for calls made
on this address. The value stored in the member is only valid if the LINECALLSTATE_BUSY
bit flag is set in the ThbTapiAddress.Caps.CallStates
member. This member uses one or more of the LINEBUSYMODE_ constants.
This property indicates the possible Called ID information that can be
provided for calls on this address. The Called ID identifies the original
destination address of a call. This property uses one ore more of the
LINECALLPARTYID_ Constants. The Called ID information for the current
call is returned in the ThbTapiCall.CalledID
properties.
The value stored in this property is only valid if the bit flag LINECALLINFOSTATE_CALLEDID
is set in the TapiAddress.Caps.CallInfoStates property.
This property indicates the possible Caller ID information that can be
provided for calls on this address. The Caller ID identifies the originator
of the call. This property uses one ore more of the LINECALLPARTYID_ Constants.
The Caller ID information for the current call is returned in the ThbTapiCall.CallerID
properties.
The value stored in this property is only valid if the bit flag LINECALLINFOSTATE_CALLERID
is set in the TapiAddress.Caps.CallInfoStates property.
This property specifies the switching capabilities or features available
for all calls on this address using one or more of the LINECALLFEATURE_
Constants. This member represents the call-related features that may possibly
be available on an address (static availability as opposed to dynamic
availability). Invoking a supported feature requires the call to be in
the proper state and the underlying line device to be opened in a compatible
mode. A zero in a bit position indicates that the corresponding feature
is never available. A one indicates that the corresponding feature may
be available if the application has the right privileges to the call and
the call is in the appropriate state for the operation to be meaningful.
This member allows an application to discover which call features can
be (and which can never be) supported by the address.
This property is a set of bit flags that indicates the possible call
information states for the address (ThbTapiAddress). For example, LINECALLINFOSTATE_CALLERID
indicates that the ThbTapiLine.OnCallerID
event will be fired.
Call information items other than those listed below
have changed. The application should check the current call information
to determine which items have changed.
One or more of the digit, tone, or media monitoring
fields in the call-information record has changed.
CallStates (DWord)
This property is a set of bit flags that indicates the possible call
states for the address (ThbTapiAddress). For example, LINECALLSTATE_CONNECTED
indicates that the ThbTapiLine.OnConnected event will be fired.
The call is being offered to the station, signaling
the arrival of a new call. In some environments, a call in the offering
state does not automatically alert the user; alerting is done by
the switch instructing the line to ring. It does not affect any
call states.
The call was offering and has been accepted. This
indicates to other (monitoring) applications that the current owner
application has claimed responsibility for answering the call. In
ISDN, this also initiates alerting to both parties.
Destination address information (a phone number)
is being sent to the switch over the call. Note that the operation
lineGenerateDigits does not place the line into the dialing state.
The call is receiving a busy tone. Busy tone indicates
that the call cannot be completed, either a circuit (trunk) or the
remote party’s station are in use.
The call has been established and the connection
is made. Information is able to flow over the call between the originating
address and the destination address.
The state of the call is not known. This may be
due to limitations of the call progress detection implementation.
ConnectedIDFlags (DWord)
This property indicates the possible Connected ID information that can
be provided for calls on this address. The Connected ID identifies the
party to which the call is actually connected. This may be different from
the called party if the call was diverted. This property uses one ore
more of the LINECALLPARTYID_ Constants. The Connected ID information for
the current call is returned in the ThbTapiCall.ConnectedID
properties.
The value stored in this property is only valid if the bit flag LINECALLINFOSTATE_CONNECTEDID
is set in the TapiAddress.Caps.CallInfoStates property.
A list of device class identifiers supported on this address.
ConnectedModes (DWord)
This property describes different substates for calls thatcan appear
on this address. The value stored in this property uses the LINECONNECTEDMODE_
constants.
Constant
Description
LINECONNECTEDMODE_ACTIVE
Indicates that the call is connected at the current station (the current
station is a participant in the call).
LINECONNECTEDMODE_INACTIVE
Indicates that the call is active at one or more other stations, but
the current station is not a participant in the call.
LINECONNECTEDMODE_ACTIVEHELD
Indicates that the station is an active participant in the call, but
that the remote party has placed the call on hold (the other party considers
the call to be in the onhold state).
LINECONNECTEDMODE_INACTIVEHELD
Indicates that the station is not an active participant in the call,
and that the remote party has placed the call on hold.
LINECONNECTEDMODE_CONFIRMED
Indicates that the service provider received affirmative notification
that the call has entered the connected state (for example, through answer
supervision or similar mechanisms).
DialToneModes (DWord)
Describes the various dial tone modes that can be reported for calls
made on this address. This member is meaningful only if the dialtone call
state can be reported. This member uses one or more of the LINEDIALTONEMODE_
constants.
Constant
Description
LINEDIALTONEMODE_EXTERNAL
This is an external (public network) dial tone.
LINEDIALTONEMODE_INTERNAL
This is an internal dial tone, as within a PBX.
LINEDIALTONEMODE_NORMAL
This is a normal dial tone, which typically is a continuous tone.
LINEDIALTONEMODE_SPECIAL
This is a special dial tone indicating that a certain condition (known
by the switch or network) is currently in effect. Special dial tones typically
use an interrupted tone. As with a normal dial tone, this indicates that
the switch is ready to receive the number to be dialed.
LINEDIALTONEMODE_UNAVAIL
The dial tone mode is unavailable and will not become known.
LINEDIALTONEMODE_UNKNOWN
The dial tone mode is not currently known but may become known later.
Describes the various disconnect modes that can be reported for calls
made on this address. This member is meaningful only if the disconnected
call state can be reported. This member uses one or more of the LINEDISCONNECTMODE_
constant:
Constant
Meaning
LINEDISCONNECTMODE_NORMAL
This is a normal disconnect request by the remote party;
the call was terminated normally.
LINEDISCONNECTMODE_UNKNOWN
The reason for the disconnect request is unknown.
LINEDISCONNECTMODE_REJECT
The remote user has rejected the call.
LINEDISCONNECTMODE_PICKUP
The call was picked up from elsewhere.
LINEDISCONNECTMODE_FORWARDED
The call was forwarded by the switch.
LINEDISCONNECTMODE_BUSY
The remote user’s station is busy.
LINEDISCONNECTMODE_NOANSWER
The remote user’s station does not answer.
LINEDISCONNECTMODE_BADADDRESS
The destination address in invalid.
LINEDISCONNECTMODE_UNREACHABLE
The remote user could not be reached.
LINEDISCONNECTMODE_CONGESTION
The network is congested.
LINEDISCONNECTMODE_INCOMPATIBLE
The remote user’s station equipment is incompatible with
the type of call requested.
LINEDISCONNECTMODE_UNAVAIL
The reason for the disconnect is unavailable and will
not become known later.
The linePickup function can be used to pick up a call on a specific address.
LINEADDRFEATURE_PICKUPGROUP
The linePickup function can be used to pick up a call in the group.
LINEADDRFEATURE_PICKUPHELD
The linePickup function (with a null destination address) can be used
to pick up a call that is held on the address. This is normally used only
in a bridged-exclusive arrangement.
LINEADDRFEATURE_PICKUPWAITING
The linePickup function (with a null destination address) can be used
to pick up a call waiting call. Note that this does not necessarily indicate
that a waiting call is actually present, because it is often impossible
for a telephony device to automatically detect such a call; it does, however,
indicate that the hook-flash function will be invoked to attempt to switch
to such a call.
LINEADDRFEATURE_SETMEDIACONTROL
Media control can be set on this address.
LINEADDRFEATURE_SETTERMINAL
The terminal modes for this address can be set.
LINEADDRFEATURE_SETUPCONF
A conference call with a NULL initial call can be set up at this address.
LINEADDRFEATURE_UNCOMPLETECALL
Call completion requests can be canceled at this address.
LINEADDRFEATURE_UNPARK
Calls can be unparked using this address. (ThbTapiLine.Unpark)
LINEADDRFEATURE_FORWARDDND
The lineForward function (with an empty destination address) can be used
to turn on the Do Not Disturb feature on the address. LINEADDRFEATURE_FORWARD
will also be set.
LINEADDRFEATURE_FORWARDFWD
The lineForward function can be used to forward calls on the address
to other numbers. LINEADDRFEATURE_FORWARD will also be set.
Flags (DWord)
Contains a series of packed bit flags that describe a variety of address
capabilities. This member uses one or more of the LINEADDRCAPFLAGS_ constants:
Constant
Description
LINEADDRCAPFLAGS_FWDNUMRINGS
Specifies whether the number of rings for a "no answer"
can be specified when forwarding calls on no answer.
LINEADDRCAPFLAGS_PICKUPGROUPID
Specifies whether or not a group ID is required for call
pickup.
LINEADDRCAPFLAGS_SECURE
Specifies whether or not calls on this address can be
made secure at call-setup time.
LINEADDRCAPFLAGS_BLOCKIDDEFAULT
Specifies whether the network by default sends or blocks
caller ID information when making a call on this address. If TRUE, ID
information is blocked by default; if FALSE, ID information is transmitted
by default.
LINEADDRCAPFLAGS_BLOCKIDOVERRIDE
Specifies whether the default setting for sending or blocking
of caller ID information can be overridden per call. If TRUE, override
is possible; if FALSE, override is not possible.
LINEADDRCAPFLAGS_DIALED
Specifies whether an destination address can be dialed
on this address for making a call. TRUE if a destination address must
be dialed; FALSE if the destination address is fixed (as with a "hot
phone").
LINEADDRCAPFLAGS_ORIGOFFHOOK
&HSpecifies whether the originating party’s phone
can automatically be taken offhook when making calls.
LINEADDRCAPFLAGS_DESTOFFHOOK
Specifies whether the called party’s phone can automatically
be forced offhook when making calls.
LINEADDRCAPFLAGS_FWDCONSULT
Specifies whether call forwarding involves the establishment
of a consultation call.
LINEADDRCAPFLAGS_SETUPCONFNULL
Specifies whether setting up a conference call starts
out with an initial call (FALSE) or with no initial call (TRUE).
LINEADDRCAPFLAGS_AUTORECONNECT
Specifies whether dropping a consultation call automatically
reconnects to the call on consultation hold. TRUE if reconnect happens
automatically; otherwise, FALSE.
LINEADDRCAPFLAGS_COMPLETIONID
Specifies whether the completion IDs returned by lineCompleteCall
are useful and unique. TRUE is useful; otherwise, FALSE.
LINEADDRCAPFLAGS_TRANSFERHELD
Specifies whether a (hard) held call can be transferred.
Often, only calls on consultation hold may be able to be transferred.
LINEADDRCAPFLAGS_TRANSFERMAKE
Specifies whether an entirely new call can be established
for use as a consultation call on transfer.
LINEADDRCAPFLAGS_CONFERENCEHELD
Specifies whether a (hard) held call can be conferenced
to. Often, only calls on consultation hold may be able to be added to
as a conference call.
LINEADDRCAPFLAGS_CONFERENCEMAKE
Specifies whether an entirely new call can be established
for use as a consultation call (to add) on conference.
LINEADDRCAPFLAGS_ PARTIALDIAL
Specifies whether partial dialing is available.
LINEADDRCAPFLAGS_FWDSTATUSVALID
Specifies whether the forwarding status in the LINEADDRESSSTATUS
structure for this address is valid.
LINEADDRCAPFLAGS_FWDINTEXTADDR
Specifies whether internal and external calls can be forwarded
to different forwarding addresses. This flag is meaningful only if forwarding
of internal and external calls can be controlled separately. It is TRUE
if internal and external calls can be forwarded to different destination
addresses; otherwise, FALSE.
LINEADDRCAPFLAGS_FWDBUSYNAADDR
Specifies whether call forwarding for busy and for no
answer can use different forwarding addresses. This flag is meaningful
only if forwarding for busy and for no answer can be controlled separately.
It is TRUE if forwarding for busy and for no answer can use different
destination addresses; otherwise, FALSE.
LINEADDRCAPFLAGS_ACCEPTTOALERT
TRUE if an offering call must be accepted using lineAccept
in order to start alerting the users at both ends of the call; otherwise,
FALSE. Typically, this is only used with ISDN.
LINEADDRCAPFLAGS_CONFDROP
TRUE if invoking lineDrop on a conference call parent
also has the side effect of dropping (disconnecting) the other parties
involved in the conference call; FALSE if dropping a conference call still
allows the other parties to talk among themselves.
LINEADDRCAPFLAGS_PICKUPCALLWAIT
TRUE if linePickup can be used to pickup a call detected
by the user as a "call waiting" call; otherwise FALSE.
ForwardModes
Describes the conditions under which calls to an address can be forwarded.
This member uses the LINEFORWARDMODE_ constants:
Constant
Description
LINEFORWARDMODE_UNCOND
Forward all calls unconditionally, irrespective of their origin. Use
this value when unconditional forwarding for internal and external calls
cannot be controlled separately. Unconditional forwarding overrides forwarding
on busy and/or no answer conditions.
LINEFORWARDMODE_UNCONDINTERNAL
Forward all internal calls unconditionally. Use this value when unconditional
forwarding for internal and external calls can be controlled separately.
LINEFORWARDMODE_UNCONDEXTERNAL
Forward all external calls unconditionally. Use this value when unconditional
forwarding for internal and external calls can be controlled separately.
LINEFORWARDMODE_UNCONDSPECIFIC
Forward all calls that originated at a specified address unconditionally
(selective call forwarding).
LINEFORWARDMODE_BUSY
Forward all calls on busy, irrespective of their origin. Use this value
when forwarding for internal and external calls on busy and on no answer
cannot be controlled separately.
LINEFORWARDMODE_BUSYINTERNAL
Forward all internal calls on busy. Use this value when forwarding for
internal and external calls on busy and on no answer can be controlled
separately.
LINEFORWARDMODE_BUSYEXTERNAL
Forward all external calls on busy. Use this value when forwarding for
internal and external calls on busy and on no answer can be controlled
separately.
LINEFORWARDMODE_BUSYSPECIFIC
Forward all calls that originated at a specified address on busy (selective
call forwarding).
LINEFORWARDMODE_NOANSW
Forward all calls on no answer, irrespective of their origin. Use this
value when call forwarding for internal and external calls on no answer
cannot be controlled separately.
LINEFORWARDMODE_NOANSWINTERNAL
Forward all internal calls on no answer. Use this value when forwarding
for internal and external calls on no answer can be controlled separately.
LINEFORWARDMODE_NOANSWEXTERNAL
Forward all external calls on no answer. Use this value when forwarding
for internal and external calls on no answer can be controlled separately.
LINEFORWARDMODE_NOANSWSPECIFIC
Forward all calls that originated at a specified address on no answer
(selective call forwarding).
LINEFORWARDMODE_BUSYNA
Forward all calls on busy or no answer, irrespective of their origin.
Use this value when forwarding; internal and external calls on busy and
on no answer cannot be controlled separately.
LINEFORWARDMODE_BUSYNAINTERNAL
Forward all internal calls on busy or no answer. Use this value when
call forwarding on busy and on no answer cannot be controlled separately
for internal calls.
LINEFORWARDMODE_BUSYNAEXTERNAL
Forward all external calls on busy or no answer. Use this value when
call forwarding on busy and on no answer cannot be controlled separately
for internal calls.
LINEFORWARDMODE_BUSYNASPECIFIC
Forward all calls that originated at a specified address on busy or no
answer (selective call forwarding).
LINEFORWARDMODE_UNKNOWN
LINEFORWARDMODE_UNAVAIL
MaxNumActiveCalls (DWord)
Contains the maximum number of active call appearances that the address
can handle. This number does not include calls on hold or calls on hold
pending transfer or conference.
MaxNumConference (DWord)
Contains the maximum number of parties that can join a single conference
call on this address.
MaxNumOnHoldCalls (DWord)
Contains the maximum number of call appearances at the address that can
be on hold.
MaxNumOnHoldPendingCalls (DWord)
Contains the maximum number of call appearances at the address that can
be on hold pending transfer or conference.
MaxNumTransConf (DWord)
Specifies the number of parties (including "self") that can
be added in a conference call that is initiated as a generic consultation
call using ThbTapiCall.SetupTransfer.
OfferingModes (DWord)
Specifies the LINEOFFERINGMODE_ values that can appear in the ThbTapiCall.StateMode
when the ThbTapiLine.OnOffering
event fires for calls on this address.
Constant
Description
LINEOFFERINGMODE_ACTIVE
Indicates that the call is alerting at the current station.
LINEOFFERINGMODE_INACTIVE
Indicates that the call is being offered at more than one station,
but the current station is not alerting. For example, it may be
an attendant station where the offering status is advisory, such
as blinking a light.
Specifies the different call park modes available at this address. This
property uses the LINEPARKMODE_ constants:
Constant
Description
LINEOFFERINGMODE_ACTIVE
Indicates that the call is alerting at the current station.
LINEOFFERINGMODE_INACTIVE
Indicates that the call is being offered at more than one station,
but the current station is not alerting. For example, it may be
an attendant station where the offering status is advisory, such
as blinking a light.
This property indicates the possible Redirecting ID information that
can be provided for calls on this address. The Redirecting ID identifies
the address which invoked the redirection of a call. This property uses
one ore more of the LINECALLPARTYID_ Constants. The Redirecting ID information
for the current call is returned in the ThbTapiCall.RedirectingID
properties.
The value stored in this property is only valid if the bit flag LINECALLINFOSTATE_REDIRECTINGID
is set in the TapiAddress.Caps.CallInfoStates property.
This property indicates the possible Redirection ID information that
can be provided for calls on this address. The Redirection ID identifies
the new destination of a call. This property uses one ore more of the
LINECALLPARTYID_ Constants. The Redirection ID information for the current
call is returned in the ThbTapiCall.RedirectionID
properties.
The value stored in this property is only valid if the bit flag LINECALLINFOSTATE_CALLEDID
is set in the TapiAddress.Caps.CallInfoStates property.
Specifies the address's capabilities for removing calls from a conference
call. This member uses one of the LINEREMOVEFROMCONF_ constants.
Constant
Meaining
LINEREMOVEFROMCONF_NONE
Parties cannot be removed from the conference call.
LINEREMOVEFROMCONF_LAST
Only the most recently added party can be removed
from the conference call.
LINEREMOVEFROMCONF_ANY
Any participating party can be removed from the
conference call.
RemoveFromConfState (DWord)
Uses the LINECALLSTATE_
constants to specify the state of the call after it has been removed from
a conference call.
SpecialInfo (DWord)
Describes the various special information types that can be reported
for calls made on this address. This member is meaningful only if the
specialInfo call state can be reported. This member uses one or more of
the LINESPECIALINFO_ constants.
Constant
Description
LINESPECIALINFO_CUSTIRREG
This special information tone precedes a vacant number, AIS, Centrex
number change and nonworking station, access code not dialed or
dialed in error, or manual intercept operator message (customer
irregularity category). LINESPECIALINFO_CUSTIRREG is also reported
when billing information is rejected and when the dialed address
is blocked at the switch.
LINESPECIALINFO_NOCIRCUIT
This special information tone precedes a no circuit or an emergency
announcement (trunk blockage category).
LINESPECIALINFO_REORDER
This special information tone precedes a reorder announcement (equipment
irregularity category). LINESPECIALINFO_REORDER is also reported
when the telephone is kept offhook too long.
LINESPECIALINFO_UNAVAIL
Specifics about the special information tone are unavailable and
will not become known.
LINESPECIALINFO_UNKNOWN
Specifics about the special information tone are currently unknown
but may become known later.
Contains the address states changes for which the application may get
notified in the ThbTapiLine.OnAddressState
event.
Constant
Meaning
LINEADDRESSSTATE_OTHER
Address status items other than those listed below have
changed. The application should check the current address status to determine
which items have changed.
LINEADDRESSSTATE_DEVSPECIFIC
The device-specific item of the address status has changed.
LINEADDRESSSTATE_INUSEZERO
The address has changed to idle (it is not in use by any
station).
LINEADDRESSSTATE_INUSEONE
The address has changed from being idle or from being
in use by many bridged stations to being in use by just one station.
LINEADDRESSSTATE_INUSEMANY
The monitored or bridged address has changed from being
in use by one station to being used by more than one station.
LINEADDRESSSTATE_NUMCALLS
The number of calls on the address has changed. This is
the result of events such as a new incoming call, an outgoing call on
the address, or a call changing its hold status.
LINEADDRESSSTATE_FORWARD
The forwarding status of the address has changed, including
the number of rings for determining a no-answer condition. The application
should check the address status to retrieve details about the address's
current forwarding status.
LINEADDRESSSTATE_TERMINALS
The terminal settings for the address have changed.
LINEADDRESSSTATE_CAPSCHANGE
Indicates that due to configuration changes made by the
user or other circumstances, one or more of the members in the LINEADDRESSCAPS
structure for the address have changed.
TransferModes (DWord)
Specifies the address's capabilities for resolving transfer requests.
Constant
Meaning
LINETRANSFERMODE_TRANSFER
The transfer is resolved by transferring the initial call
to the consultation call. Both calls will become idle to the application.
LINETRANSFERMODE_CONFERENCE
The transfer is resolved by establishing a three-way conference
between the application, the party connected to the initial call, and
the party connected to the consultation call. A conference call is created
when this option is selected.