LINEADDRESSCAPS
The LINEADDRESSCAPS structure describes the capabilities of a specified address.
typedef struct lineaddresscaps_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwLineDeviceID;
DWORD dwAddressSize;
DWORD dwAddressOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwAddressSharing;
DWORD dwAddressStates;
DWORD dwCallInfoStates;
DWORD dwCallerIDFlags;
DWORD dwCalledIDFlags;
DWORD dwConnectedIDFlags;
DWORD dwRedirectionIDFlags;
DWORD dwRedirectingIDFlags;
DWORD dwCallStates;
DWORD dwDialToneModes;
DWORD dwBusyModes;
DWORD dwSpecialInfo;
DWORD dwDisconnectModes;
DWORD dwMaxNumActiveCalls;
DWORD dwMaxNumOnHoldCalls;
DWORD dwMaxNumOnHoldPendingCalls;
DWORD dwMaxNumConference;
DWORD dwMaxNumTransConf;
DWORD dwAddrCapFlags;
DWORD dwCallFeatures;
DWORD dwRemoveFromConfCaps;
DWORD dwRemoveFromConfState;
DWORD dwTransferModes;
DWORD dwParkModes;
DWORD dwForwardModes;
DWORD dwMaxForwardEntries;
DWORD dwMaxSpecificEntries;
DWORD dwMinFwdNumRings;
DWORD dwMaxFwdNumRings;
DWORD dwMaxCallCompletions;
DWORD dwCallCompletionConds;
DWORD dwCallCompletionModes;
DWORD dwNumCompletionMessages;
DWORD dwCompletionMsgTextEntrySize;
DWORD dwCompletionMsgTextSize;
DWORD dwCompletionMsgTextOffset;
} LINEADDRESSCAPS, FAR *LPLINEADDRESSCAPS;
Members
-
dwTotalSize
-
The total size in bytes allocated to this data structure.
-
dwNeededSize
-
The size in bytes for this data structure that is needed to hold all the returned information.
-
dwUsedSize
-
The size in bytes of the portion of this data structure that contains useful information.
-
dwLineDeviceID
-
The device identifier of the line device with which this address is associated.
-
dwAddressSize
-
dwAddressOffset
-
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized address field.
-
dwDevSpecificSize
-
dwDevSpecificOffset
-
The size in bytes and the offset in bytes from the beginning of this data structure of the variably sized device-specific field.
-
dwAddressSharing
-
The sharing mode of the address. This member uses the following LINEADDRESSSHARING_ constants:
-
LINEADDRESSSHARING_PRIVATE
-
An address with private sharing mode is only assigned to a single line or station.
-
LINEADDRESSSHARING_BRIDGEDEXCL
-
An address with a bridged-exclusive sharing mode is assigned to one or more other lines or stations. The exclusive portion refers to the fact that only one of the bridged parties can be connected with a remote party at any given time.
-
LINEADDRESSSHARING_BRIDGEDNEW
-
An address with a bridged-new sharing mode is assigned to one or more other lines or stations. The new portion refers to the fact that activities by the different bridged parties result in the creation of new calls on the address.
-
LINEADDRESSSHARING_BRIDGEDSHARED
-
An address with a bridged-shared sharing mode is also assigned to one or more other lines or stations. The shared portion refers to the fact that if one of the bridged parties is connected with a remote party, the remaining bridged parties can share in the conversation (as in a conference) by activating that call appearance.
-
LINEADDRESSSHARING_MONITORED
-
An address with a monitored address mode simply monitors the status of that address. The status is either idle or in use. The LINE_ADDRESSSTATE message notifies the application about these changes.
-
dwAddressStates
-
Contains the address state changes for which the application can be notified in the LINE_ADDRESSSTATE callback message. This member uses the following LINEADDRESSSTATE_ constants:
-
LINEADDRESSSTATE_OTHER
-
Address-status items other than those listed below have changed.
-
LINEADDRESSSTATE_DEVSPECIFIC
-
The device-specific item of the address status has changed.
-
LINEADDRESSSTATE_INUSEZERO
-
The address has changed to idle (it is now in use by zero stations).
-
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 in use 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 inbound call, an outbound 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 checks the address status to determine details about the address's current forwarding status.
-
LINEADDRESSSTATE_TERMINALS
-
The terminal settings for the address have changed.
-
dwCallInfoStates
-
Describes the call info elements that are meaningful for all calls on this address, and uses the LINECALLINFOSTATE_ constants. An application can get notified about changes in some of these states in LINE_CALLINFO messages. This member uses the following LINECALLINFOSTATE_ constants:
-
LINECALLINFOSTATE_OTHER
-
Call information items other than those listed below have changed.
-
LINECALLINFOSTATE_DEVSPECIFIC
-
The device-specific field of the call-information record.
-
LINECALLINFOSTATE_BEARERMODE
-
The bearer mode field of the call-information record.
-
LINECALLINFOSTATE_RATE
-
The rate field of the call-information record.
-
LINECALLINFOSTATE_MEDIAMODE
-
The media mode field of the call-information record.
-
LINECALLINFOSTATE_APPSPECIFIC
-
The application-specific field of the call-information record.
-
LINECALLINFOSTATE_CALLID
-
The call identifier field of the call-information record.
-
LINECALLINFOSTATE_RELATEDCALLID
-
The related call identifier field of the call-information record.
-
LINECALLINFOSTATE_ORIGIN
-
The origin field of the call-information record.
-
LINECALLINFOSTATE_REASON
-
The reason field of the call-information record.
-
LINECALLINFOSTATE_COMPLETIONID
-
The completion identifier field of the call-information record.
-
LINECALLINFOSTATE_NUMOWNERINCR
-
The number of owner field in the call-information record was increased.
-
LINECALLINFOSTATE_NUMOWNERDECR
-
The number of owner field in the call-information record was decreased.
-
LINECALLINFOSTATE_NUMMONITORS
-
The number of monitors field in the call-information record has changed.
-
LINECALLINFOSTATE_TRUNK
-
The trunk field of the call-information record.
-
LINECALLINFOSTATE_CALLERID
-
One of the callerID-related fields of the call-information record.
-
LINECALLINFOSTATE_CALLEDID
-
One of the calledID-related fields of the call-information record.
-
LINECALLINFOSTATE_CONNECTEDID
-
One of the connectedID-related fields of the call-information record.
-
LINECALLINFOSTATE_REDIRECTIONID
-
One of the redirectionID-related fields of the call-information record.
-
LINECALLINFOSTATE_REDIRECTINGID
-
One of the redirectingID-related fields of the call-information record.
-
LINECALLINFOSTATE_DISPLAY
-
The display field of the call-information record.
-
LINECALLINFOSTATE_USERUSERINFO
-
The user-user information of the call-information record.
-
LINECALLINFOSTATE_HIGHLEVELCOMP
-
The high-level compatibility field of the call-information record.
-
LINECALLINFOSTATE_LOWLEVELCOMP
-
The low-level compatibility field of the call-information record.
-
LINECALLINFOSTATE_CHARGINGINFO
-
The charging information of the call-information record.
-
LINECALLINFOSTATE_TERMINAL
-
The terminal mode information of the call-information record.
-
LINECALLINFOSTATE_DIALPARAMS
-
The dial parameters of the call-information record.
-
LINECALLINFOSTATE_MONITORMODES
-
One or more of the digit, tone, or media monitoring fields in the call-information record.
-
dwCallerIDFlags
-
dwCalledIDFlags
-
dwConnectedIDFlags
-
dwRedirectionIDFlags
-
dwRedirectingIDFlags
-
These fields describe the various kinds of party identifier information that can be provided for calls on this address. This member uses the following LINECALLPARTYID_ constants:
-
LINECALLPARTYID_BLOCKED
-
Caller identifier information for the call is blocked by the caller, but would otherwise be available.
-
LINECALLPARTYID_OUTOFAREA
-
Caller identifier information for the call is not available as it is not propagated all the way by the network.
-
LINECALLPARTYID_NAME
-
The caller identifier information for the call is the caller's name (from a table maintained inside the switch). It is provided in the caller identifier name variably sized field.
-
LINECALLPARTYID_ADDRESS
-
The caller identifier information for the call is the caller's number, and is provided in the caller identifier variably sized field.
-
LINECALLPARTYID_PARTIAL
-
Caller identifier information for the call is valid, but is limited to partial number information.
-
LINECALLPARTYID_UNKNOWN
-
Caller identifier information is currently unknown, but it can become known later.
-
LINECALLPARTYID_UNAVAIL
-
Caller identifier information is unavailable and cannot become known later.
-
dwCallStates
-
The various call states that can be reported for calls on this address. This member uses the following LINECALLSTATE_ constants:
-
LINECALLSTATE_IDLE
-
The call is idle; no call actually exists.
-
LINECALLSTATE_OFFERING
-
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.
-
LINECALLSTATE_ACCEPTED
-
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.
-
LINECALLSTATE_DIALTONE
-
The call is receiving a dial tone from the switch, which means that the switch is ready to receive a dialed number.
-
LINECALLSTATE_DIALING
-
Destination address information (a phone number) is being sent to the switch over the call. Note that the operation TSPI_lineGenerateDigits does not place the line into the dialing state.
-
LINECALLSTATE_RINGBACK
-
The call is receiving ringback from the called address. Ringback indicates that the other station has been reached and is being alerted.
-
LINECALLSTATE_BUSY
-
The call is receiving a busy tone. Busy tone indicates that the call cannot be completed because either a circuit (trunk) or the remote party's station is in use.
-
LINECALLSTATE_SPECIALINFO
-
Special information is sent by the network. Special information is typically sent when the destination cannot be reached.
-
LINECALLSTATE_CONNECTED
-
The call has been established, the connection is made. Information is able to flow over the call between the originating address and the destination address.
-
LINECALLSTATE_PROCEEDING
-
Dialing has completed and the call is proceeding through the switch or telephone network.
-
LINECALLSTATE_ONHOLD
-
The call is on hold by the switch.
-
LINECALLSTATE_CONFERENCED
-
The call is currently a member of a multiparty conference call.
-
LINECALLSTATE_ONHOLDPENDCONF
-
The call is currently on hold while it is being added to a conference.
-
LINECALLSTATE_ONHOLDPENDTRANSFER
-
The call is currently on hold awaiting transfer to another number.
-
LINECALLSTATE_DISCONNECTED
-
The remote party has disconnected from the call.
-
LINECALLSTATE_UNKNOWN
-
The state of the call is not known. This can be due to limitations of the call progress detection implementation.
-
dwDialToneModes
-
The various dial tone modes that can possibly be reported for calls made on this address. This member uses the following LINEDIALTONEMODE_ constants. This member is only meaningful if the dialtone call state can be reported.
-
LINEDIALTONEMODE_NORMAL
-
This is a normal dial tone that typically is a continuous tone.
-
LINEDIALTONEMODE_SPECIAL
-
This is a special dial tone indicating a certain condition is currently in effect.
-
LINEDIALTONEMODE_INTERNAL
-
This an internal dial tone, as within a PBX.
-
LINEDIALTONEMODE_EXTERNAL
-
This is an external (public network) dial tone.
-
LINEDIALTONEMODE_UNKNOWN
-
The dial tone mode is currently unknown, but can become known later.
-
LINEDIALTONEMODE_UNAVAIL
-
The dial tone mode is unavailable and cannot become known.
-
dwBusyModes
-
The various busy modes that can possibly be reported for calls made on this address. This member uses the following LINEBUSYMODE_ constants. This member is only meaningful if the busy call state can be reported.
-
LINEBUSYMODE_STATION
-
The busy signal indicates that the called party's station is busy. This is usually signaled by means of a normal busy tone.
-
LINEBUSYMODE_TRUNK
-
The busy signal indicates that a trunk or circuit is busy. This is usually signaled by means of a long busy tone.
-
LINEBUSYMODE_UNKNOWN
-
The busy signal's specific mode is currently unknown, but can become known later.
-
LINEBUSYMODE_UNAVAIL
-
The busy signal's specific mode is unavailable and cannot become known.
-
dwSpecialInfo
-
The various kinds of special information that can be reported for calls made on this address. It uses the following LINESPECIALINFO_ constants. This member is only meaningful if the specialInfo call state can be reported.
-
LINESPECIALINFO_NOCIRCUIT
-
This special information tone precedes a no-circuit or emergency announcement (trunk blockage category).
-
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_REORDER
-
This special information tone precedes a reorder announcement (equipment irregularity category).
-
LINESPECIALINFO_UNKNOWN
-
Specifics about the special information tone are currently unknown but can become known later.
-
LINESPECIALINFO_UNAVAIL
-
Specifics about the special information tone are unavailable, and cannot become known.
-
dwDisconnectModes
-
The various disconnect modes that can possibly be reported for calls made on this address. This member uses the LINEDISCONNECTMODE_ constants listed below. This member is only meaningful if the disconnected call state can be reported.
-
LINEDISCONNECTMODE_NORMAL
-
A normal disconnect request by the remote party; the call is 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_CONGESTION
-
The network is congested.
-
LINEDISCONNECTMODE_INCOMPATIBLE
-
The remote user's station equipment is incompatible for the type of call requested.
-
LINEDISCONNECTMODE_UNAVAIL
-
The reason for the disconnect is unavailable and cannot become known later.
-
LINEDISCONNECTMODE_NODIALTONE
-
A dial tone was not detected within a service-provider defined timeout, at a point during dialing when one was expected (such as at a "W" in the dialable string). This can also occur without a service-provider defined timeout period or without a value specified in the dwWaitForDialTone member of the LINEDIALPARAMS structure.
-
dwMaxNumActiveCalls
-
The maximum number of active call appearances that the address can handle. This number does not include calls on hold or on hold pending transfer or conference.
-
dwMaxNumOnHoldCalls
-
The maximum number of call appearances at the address that can be on hold.
-
dwMaxNumOnHoldPendingCalls
-
The maximum number of call appearances at the address that can be on hold pending transfer or conference.
-
dwMaxNumConference
-
The maximum number of parties that can be conferenced in a single conference call on this address.
-
dwMaxNumTransConf
-
The number of parties (including "self") that can be added in a conference call that is initiated as a generic consultation call using the lineSetupTransfer function.
-
dwAddrCapFlags
-
A series of packed bit flags that describe a variety of address capabilities. This member uses the following LINEADDRCAPFLAGS_ constants:
-
LINEADDRCAPFLAGS_FWDNUMRINGS
-
Specify whether the number of rings for a no answer can be specified when forwarding calls on no answer.
-
LINEADDRCAPFLAGS_PICKUPGROUPID
-
Specify whether a group identifier is required for call pickup.
-
LINEADDRCAPFLAGS_SECURE
-
Specify whether calls on this address can be made secure at call setup time.
-
LINEADDRCAPFLAGS_BLOCKIDDEFAULT
-
Specify whether the network by default sends or blocks caller ID information when making a call on this address. If TRUE, identifier information is blocked by default; if FALSE, identifier information is transmitted by default.
-
LINEADDRCAPFLAGS_BLOCKIDOVERRIDE
-
Specify 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
-
Specify whether a 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
-
Specify whether the originating party's phone can automatically be taken offhook when making calls.
-
LINEADDRCAPFLAGS_DESTOFFHOOK
-
Specify whether the called party's phone can automatically be forced offhook when making calls.
-
LINEADDRCAPFLAGS_FWDCONSULT
-
Specify whether call forwarding involves the establishment of a consultation call.
-
LINEADDRCAPFLAGS_SETUPCONFNULL
-
Specify whether setting up a conference call starts out with an initial call (FALSE) or with no initial call (TRUE).
-
LINEADDRCAPFLAGS_AUTORECONNECT
-
Specify whether dropping a consultation call automatically reconnects to the call on consultation hold. TRUE if reconnect happens automatically, otherwise FALSE.
-
LINEADDRCAPFLAGS_COMPLETIONID
-
Specify whether the completion identifiers returned by TSPI_lineCompleteCall are useful and unique. TRUE if useful; otherwise, FALSE.
-
LINEADDRCAPFLAGS_TRANSFERHELD
-
Specify whether a (hard) held call can be transferred. Often, only calls on consultation hold can be transferred.
-
LINEADDRCAPFLAGS_TRANSFERMAKE
-
Specify whether an entirely new call can be established for use as a consultation call on transfer.
-
LINEADDRCAPFLAGS_CONFERENCEHELD
-
Specify whether a (hard) held call can be conferenced to. Often, only calls on consultation hold can be added to as a conference call.
-
LINEADDRCAPFLAGS_CONFERENCEMAKE
-
Specify whether an entirely new call can be established for use as a consultation call (to add) on conference.
-
LINEADDRCAPFLAGS_PARTIALDIAL
-
Specify whether partial dialing is available.
-
LINEADDRCAPFLAGS_FWDSTATUSVALID
-
Specify whether the forwarding status in the LINEADDRESSSTATUS structure for this address is valid.
-
LINEADDRCAPFLAGS_FWDINTEXTADDR
-
Specify whether internal and external calls can be forwarded to different forwarding addresses. This flag is only meaningful if forwarding of internal and external calls can be controlled separately. This flag is TRUE if internal and external calls can be forwarded to different destination addresses; otherwise, FALSE.
-
LINEADDRCAPFLAGS_FWDBUSYNAADDR
-
Specify whether call forwarding for busy and no answer can use different forwarding addresses. This flag is only meaningful if forwarding for busy and no answer can be controlled separately. This flag is TRUE if forwarding for busy and no answer can be use different destination addresses; othewise, FALSE.
-
LINEADDRCAPFLAGS_ACCEPTTOALERT
-
This flag is TRUE if an offering call must be accepted using lineAccept to start alerting the users at both ends of the call; Otherwise, it is FALSE. This flag is typically only used with ISDN.
-
LINEADDRCAPFLAGS_CONFDROP
-
This flag is TRUE if lineDrop of a conference call parent also has the side effect of dropping (disconnecting) the other parties involved in the conference call. It is FALSE if dropping a conference call still allows the other parties to talk among themselves.
-
LINEADDRCAPFLAGS_PICKUPCALLWAIT
-
This flag is TRUE if linePickup can be used to pick up a call detected by the user as a call-waiting call. Otherwise, it is FALSE.
-
dwCallFeatures
-
The switching capabilities or features available for all calls on this address, of type LINECALLFEATURE. 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 aplication to discover early on which call features can be and which can never be supported by the address.
-
dwRemoveFromConfCaps
-
The address's capabilities for removing calls from a conference call. This member uses the following LINEREMOVEFROMCONF_ constants:
-
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.
-
dwRemoveFromConfState
-
This member is of the type LINECALLSTATE, and specifies the state of the call after it is removed from a conference call.
-
dwTransferModes
-
The address's capabilities for resolving transfer requests. This member uses the following LINETRANSFERMODE_ constants:
-
LINETRANSFERMODE_TRANSFER
-
Resolve the initiated transfer by transferring the initial call to the consultation call.
-
LINETRANSFERMODE_CONFERENCE
-
Resolve the initiated transfer by conferencing all three parties into a three-way conference call. A conference call is created and returned to the application.
-
dwParkModes
-
Specifies the different call park modes available at this address, and uses the following LINEPARKMODE_ constants:
-
LINEPARKMODE_DIRECTED
-
Specify directed call park. The address where the call is to be parked must be supplied to the switch.
-
LINEPARKMODE_NONDIRECTED
-
Specify nondirected call park. The address where the call is parked is selected by the switch and provided by the switch to the application.
-
dwForwardModes
-
The different modes of forwarding available for this address. This member uses the following LINEFORWARDMODE_ constants:
-
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 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 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 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/no answer irrespective of their origin. Use this value when forwarding for internal and external calls on busy and no answer cannot be controlled separately.
-
LINEFORWARDMODE_BUSYNAINTERNAL
-
Forward all internal calls on busy/no answer. Use this value when call forwarding on busy and no answer cannot be controlled separately for internal calls.
-
LINEFORWARDMODE_BUSYNAEXTERNAL
-
Forward all external calls on busy/no answer. Use this value when call forwarding on busy and no answer cannot be controlled separately for internal calls.
-
LINEFORWARDMODE_BUSYNASPECIFIC
-
Forward all calls that originated at a specified address on busy/no answer (selective call forwarding).
-
dwMaxForwardEntries
-
The maximum number of entries that can be passed to TSPI_lineForward in the lpForwardList parameter.
-
dwMaxSpecificEntries
-
The maximum number of entries in the lpForwardList parameter passed to TSPI_lineForward that can contain forwarding instructions based on a specific caller ID (selective call forwarding). This member is zero if selective call forwarding is not supported.
-
dwMinFwdNumRings
-
The minimum number of rings that can be set to determine when a call is officially considered "no answer."
-
dwMaxFwdNumRings
-
The maximum number of rings that can be set to determine when a call is officially considered "no answer." If this number of rings cannot be set, then dwMinFwdNumRings and dwMaxNumRings are equal.
-
dwMaxCallCompletions
-
The maximum number of concurrent call completion requests that can be outstanding on this line device. Zero implies that call completion is not available.
-
dwCallCompletionCond
-
The different call conditions under which call completion can be requested. This member uses the following LINECALLCOMPLCOND_ constants:
-
LINECALLCOMPLCOND_BUSY
-
Complete the call under the busy condition.
-
LINECALLCOMPLCOND_NOANSWER
-
Complete the call under the ringback, no-answer condition.
-
dwCallCompletionModes
-
The way in which the call can be completed. This member uses the following LINECALLCOMPLMODE_ constants:
-
LINECALLCOMPLMODE_CAMPON
-
Queue the call until the call can be completed.
-
LINECALLCOMPLMODE_CALLBACK
-
Request the called station to return the call when it returns to idle.
-
LINECALLCOMPLMODE_INTRUDE
-
Add the application to the existing call at the called station if busy (barge in).
-
LINECALLCOMPLMODE_MESSAGE
-
Leave a short, predefined message for the called station (Leave Word Calling). A specific message can be identified.
-
dwNumCompletionMessages
-
The number of call completion messages from which a selection can be made when using the LINECALLCOMPLMODE_MESSAGE option. Individual messages are identified by values in the range 0 through dwNumCompletionMessages minus one.
-
dwCompletionMsgTextEntrySize
-
The size in bytes of each of the call completion text descriptions pointed at by dwCompletionMsgTextSize/Offset.
-
dwCompletionMsgTextSize
-
dwCompletionMsgTextOffset
-
The size in bytes and the offset from the beginning of this data structure in bytes of the variably sized field containing descriptive text about each of the call completion messages. Each message is dwCompletionMsgTextEntrySize bytes long. The string format of these textual descriptions is indicated by dwStringFormat in the line's device capabilities.
Remarks
Device-specific extensions should use the DevSpecific (dwDevSpecificSize and dwDevSpecificOffset) variably sized area of this data structure.
See Also
LINEADDRESSMODE_ Constants, LINEADDRESSSTATUS, LINEBEARERMODE_ Constants, LINECALLCOMPLCOND_ Constants, LINECALLCOMPLMODE_ Constants, LINECALLFEATURE_ Constants, LINECALLORIGIN_ Constants, LINEDIALPARAMS, LINEFORWARDMODE_ Constants, LINEMEDIAMODE_ Constants, LINEPARKMODE_ Constants, TSPI_lineCompleteCall, TSPI_lineForward, TSPI_lineGenerateDigits, TSPI_lineGetAddressCaps