Tapi Configuration Service Provider

  • Article

Send Feedback

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   This Configuration Service Provider is not available on Windows Mobile-based Pocket PCs.

Note   This Configuration Service Provider is managed over the OMA Client Provisioning (formerly WAP) protocol.

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 about roles, see Security Roles and Default Roles for Configuration Service Providers.

In the root characteristic, the default security roles are defined. The default security role maps to each subnode unless specific permission is granted to the subnode. The following table shows the default settings:

Permissions Read/write
Roles allowed to query and update setting Manager

The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning.

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.

Parameters

  • 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.

Note   The value for this parm should be preset if possible. Applications such as smartdial make use of this parm when performing searches for matching phone numbers. The value for this parm can be placed in ROM by OEMs during manufacture or provisioned by Mobile Operators before deployment to their customers.

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 Manager

Operator

Operator - TPS

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.

Note   The value for this parm should be preset if possible. Applications such as smartdial make use of this parm when performing searches for matching phone numbers. The value for this parm can be placed in ROM by OEMs during manufacture or provisioned by Mobile Operators before deployment to their customers.

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 Manager

Operator

Operator - TPS

AuthenticatedUser

  • CurrentDefaultLine
    Identifies the current outgoing line.

    The following table shows the default settings.

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

    Operator

    Operator - TPS

  • 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

  • RILVersion
    Indicates whether the RIL version entry is displayed in the About control panel application.

    The following table shows the default settings.

    Permissions Read-only
    Data type String
    Roles allowed to query and update setting Manager

    Operator

    Operator - TPS

    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 Manager

    Operator TPS

  • 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:

  • 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:

  • 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

  • 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

  • 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

  • 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:

  • 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:

  • 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

  • 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

  • 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:

  • 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.

    Permissions Read/write
    Data type boolean
    Label Provide call waiting notifications

  • 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

  • VoicePrivacy
    Indicates whether to show the voice privacy icon when voice privacy is dropped and whether to play an event sound when the user is on a call.

    The following table shows the default settings.

    Permissions Read/Write
    Data type Boolean
    Label Notify me when voice privacy is unavailable
    Roles allowed to query and update setting Manager

    AuthenticatedUser

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.

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

Use these elements to build standard OMA Client Provisioning (formerly WAP) configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to generally use the Microsoft custom elements, see Provisioning XML File Examples.

For information about OMA Client Provisioning, see OMA Client Provisioning Files.

See Also

Configuration Service Provider Reference for Windows Mobile-Based Devices | TAPI Configuration Service Provider Examples for OMA Client Provisioning

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.