TAPI Configuration Service Provider

  • Article

Use the TAPI Configuration Service Provider to configure telephony settings. The TAPI Configuration Service Provider is used for configuring the Global System for Mobile Communications (GSM) telephony settings on the device.

Note Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information, see Security Roles.

Note This Configuration Service Provider is not available on Windows Mobile-based Pocket PC.

Characteristics

  • FWD_CODE
    This characteristic is used to configure the call forwarding settings. The following table lists the possible values.

    Value Description
    No-Reply Forward when there is no reply.
    Not-Reachable Forward when not reachable.
    Busy Forward when busy.
    Unconditional Forward unconditionally.

  • FWD_CODE/<INFOCLASS>
    This characteristic determines the class of information. The following table lists the possible values.

    Value Description
    All-Bearers All calls.
    Voice Voice calls.
    Data Data calls.
    Fax Fax calls.

Parms

  • AreaCode
    Identifies the home area code of the device. The area code is used by TAPI to plan call costs and for phone number matching and formatting heuristics.

    This parm is used in the root TAPI characteristic.

    The following table shows the default settings for this parm.

    Permissions read/write
    Data type string
    Label Area code:
    Semantic type phone-number
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • CellBroadcastEnabled
    Enables or disables receipt of cell broadcast messages. A value of 0 indicates cell broadcast messages are disabled. A value of 1 indicates that they are enabled.

    This parm is used in the root TAPI characteristic.

    The following table shows the default settings.

    Permissions read/write
    Data type boolean
    Label Enable channels
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • CellBroadcastEnableTopicList
    Enables or disables the cell broadcast topic list. A value of 0 indicates cell broadcast topic list is disabled. A value of 1 indicates that it is enabled.

    This parm is used in the root TAPI characteristic.

    The following table shows the default settings.

    Permissions read/write
    Data type boolean
    Label Receive channel list
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • CellBroadcastLanguage
    Identifies which cell broadcast messages to receive based on their language. This parm is used in the root TAPI characteristic.

    The following list shows the possible values:

    • 131071 indicates all languages
    • 2 indicates German
    • 4 indicates English
    • 8 indicates Italian
    • 16 indicates French
    • 32 indicates Spanish
    • 64 indicates Dutch
    • 128 indicates Swedish
    • 256 indicates Danish
    • 512 indicates Portuguese
    • 1024 indicates Finnish
    • 2048 indicates Norwegian
    • 4096 indicates Greek
    • 8192 indicates Turkish
    • 16384 indicates Hungarian
    • 32768 indicates Polish
    • 65536 indicates Czech

    The following table shows the default settings.

    Permissions read/write
    Data type integer
    Label language
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • CountryCode
    Identifies the home country code of the device. The country code is used by TAPI to plan call costs and for phone number matching and formatting heuristics.

    This parm is used in the root TAPI characteristic.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Country code:
    Semantic type phone-number
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • RadioVersion
    Reads the Radio Stack Version display string.

    This parm is used in the root TAPI characteristic.

    The following table shows the default settings:

    Permissions read-only
    Data type string
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • SMSC
    Sets the Short Message Service Center address.

    This parm is used in the root TAPI characteristic.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label SMS service center:
    Semantic type phone-number
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • TAPI_BARRING_IN
    Used to block incoming messages and calls. The following list shows the possible values:

    • A value of zero (0) indicates no calls are blocked.
    • A value of 1 blocks incoming calls when roaming.
    • A value of 2 blocks all incoming calls.

    The following table shows the default settings.

    Permissions read/write
    Data type integer
    Label Block incoming calls:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_BARRING_OUT
    Used to block outgoing messages and calls. The following list shows the possible values:

    • A value of zero (0) indicates no messages are blocked.
    • A value of 1 blocks outgoing international calls except to home.
    • A value of 2 blocks all outgoing international calls.
    • A value of 3 blocks all outgoing calls.

    This parm is used in the root TAPI characteristic.

    The following table shows the default settings.

    Permissions read/write
    Data type integer
    Label Block outgoing calls:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_BARRING_PASSWORD
    This parm is used in the root TAPI characteristic to enter the network call barring password.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Call barring password:
    Semantic type numeric-password
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_FIXEDDIAL_ENABLED
    This parm is used in the root TAPI characteristic to enable or disable fixed dialing. The following table lists the possible values.

    This parm is used in the root TAPI characteristic.

    Value Description
    0 Fixed dialing is disabled
    1 Fixed dialing is enabled

    The following table shows the default settings.

    Permissions read/write
    Data type boolean
    Label Enable fixed dialing
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_FIXEDDIAL_NUMBERS
    This parm is used in the root TAPI characteristic to configure the list of fixed dialing numbers.

    The following table shows the default settings.

    Permissions read/write
    Data type string
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_FORWARD_ADDRESS
    This parm is used in the call forwarding characteristic to set the phone number to which messages or calls should be forwarded.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Forward calls to:
    Semantic type phone-number
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_FORWARD_ENABLED
    This parm is used in the call forwarding characteristic to enable or disable the call forwarding function. The following table lists the possible values.

    Value Description
    0 Off
    1 On

    The following table shows the default settings.

    Permissions Read/Write
    Data type Boolean
    Label  
    Roles allowed to query and update setting Manager

    AuthenticatedUser

    This parm is used in the following characteristics:

    • TAPI Configuration Service Provider under No-Reply\*\, and additionally has the Enable call forwarding when no reply label.
    • TAPI Configuration Service Provider under Unconditional\*\, and additionally has the Enable call forwarding of all calls label.
    • TAPI Configuration Service Provider under Busy\*\, and additionally has the Enable call forwarding when the phone is busy label.
    • TAPI Configuration Service Provider under Not-Reachable\*\,and additionally has the Enable call forwarding when unavailable label.

  • TAPI_FORWARD_TIMEOUT
    This parm is used to set the length of the timeout on forwarded messages or calls that receive no reply. This can be set to 5, 10, 15, 20, 25, or 30 seconds.

    This parm is used in the root call forwarding characteristic.

    The following table shows the default settings.

    Permissions Read/Write
    Data type Integer
    Label Forward after:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_NETWORK_AUTOMATIC
    This parm is used in the root TAPI characteristic to choose which network selection method the phone should use. The following table lists the possible values.

    Value Description
    0 Automatic
    1 Manual

    The following table shows the default settings.

    Permissions read/write
    Data type integer
    Label Network selection:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_NETWORK_CURRENT
    This parm is used in the root TAPI characteristic to identify the current network.

    The following table shows the default settings.

    Permissions read-only
    Data type string
    Label Current network:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_NETWORK_PREFERRED
    This parm is used in the root TAPI characteristic to identify the list of preferred networks.

    The following table shows the default settings.

    Permissions read/write
    Data type string
    Label Preferred networks:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_NETWORK_SELECT_CURRENT
    This parm is used in the root TAPI characteristic to select the current network manually.

    The following table shows the default settings.

    Permissions read/write
    Data type integer
    Label Select current network:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_PIN2
    This parm is used in the root TAPI characteristic to enter PIN2 to access fixed dialing.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Enter PIN2:
    Semantic type numeric-password
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_SEND_CALLID
    Enables or disables the ability to send caller ID information for the device . The following list shows the possible values:

    • 0 provides the caller ID of the to all callers.
    • 1 prevents the caller ID from being provided to any callers.
    • 2 provides the caller ID to callers listed in My Contacts.

    The following table shows the default settings.

    Permissions read/write
    Data type integer
    Label Provide my caller ID to:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TAPI_WAITING
    Enables or disables call waiting. A value of 0 disables call waiting. A value of 1 enables it.

    This parm is used in the root TAPI characteristic.

    The following table shows the default settings.

v

Permissions read/write
Data type boolean
Label Provide call waiting notifications
Roles allowed to query and update setting Manager

AuthenticatedUser

  • Voicemail1
    Identifies the voice mail number for line 1. This parm is used in the root TAPI characteristic.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Voice mail number (L1):
    Semantic type phone-number
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • Voicemail2
    Sets the voice mail number for line 2. This parm is used in the root TAPI characteristic.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Voice mail number (L2):
    Semantic Type Phone-number
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

    AuthenticatedUser

Elements

Elements Available
parm-query Yes
noparm No
nocharacteristic No
characteristic-query No

For information about specific elements, see MSPROV DTD Elements.

See Also

Configuration Service Provider Reference for Windows Mobile Devices| TAPI Configuration Service Provider Examples

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.