Registry Configuration Service Provider

  • Article

Although the registry is directly accessible, accessing the registry through the metabase is the preferred method for updating settings. This is accomplished by using the Configuration Service Provider specific to the settings that require an update.

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.

Querying the registry at the top level is not allowed. All parms must be queried individually. The underlying data store of the Registry is typed. Be sure to use the datatype attribute of the <parm> tag.

This documentation describes the default characteristics. Additional characteristics may be added.

Because the Registry Configuration Service Provider uses the backslash (\) character as a separator between key names, backslashes which occur in the name of a registry key must be escaped. Backslashes can be escaped by using two sequential backslashes (\\).

Note Characteristics or parms for the FileOperation Configuration Service Provider, Metabase Configuration Service Provider, and Registry Configuration Service Provider can contain an additional attribute called "translation". The two values for this attribute are "filesystem" and "install". A translation of type "filesystem" causes all file paths to be canonicalized (that is, double backslashes are removed). A translation of type "install" includes all the translations done for "filesystem", but also translates all CE Strings (for example, %CE2%) into the correct file path for the device. CabWizSP will automatically add the appropriate translation to file operations and registry keys in an .inf file.

Characteristics

  • <path>
    This characteristic is the path to the registry key. For example, "Registry\HKLM\Software\Microsoft\TestKey3" is a valid path.

Parms

  • *
    The following table shows the default settings for this parm:

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

    This parm is used in the following characteristics:

    • Parms in the Registry\HKLM\SOFTWARE\Microsoft characteristic identify whether to lock down the Microsoft branch of Software.

    • Parms in the Registry\HKLM\SOFTWARE characteristic must be accessible to any installed applications.

    • Parms in the Registry\HKLM\Windows CE Services\Synchronization\Objects characteristic serve as the registration point for any other sync providers for ActiveSync.

    • Parms in the Registry\HKLM\SOFTWARE\Microsoft\Windows CE\CurrentVersion\AeDebug\Enabled are used as a flag used for Windows CE debugging operations. This parm is not specific to ActiveSync.

    • Parms in the Registry\HKLM\SOFTWARE\Microsoft\Windows CE Services characteristic identify the ActiveSync version.

    • Parms in the Registry\HKLM\SOFTWARE\Apps\Microsoft Application Installer\fAskOptions characteristic are used by wceload.exe for ActiveSync.

    • Parms in the Registry\HKLM\SOFTWARE\Apps\Microsoft Application Installer\nDynamicDelete characteristic are used by wceload.exe for ActiveSync.

    • Parms in the Registry\HKLM\SOFTWARE\Apps\Microsoft Application Installer\Supported characteristic are used by wceload.exe for ActiveSync.

    • Parms in the Registry\HKLM\SOFTWARE\Apps\Microsoft Application Installer\fAskDest characteristic are used by wceload.exe for ActiveSync.

    • Parms in the Registry\HKLM\Security\WAP\PGList characteristic identify the list of proxy gateways.

    • Parms in the root characteristic allow access to the entire registry.

    • Parms in the Registry\HKLM\Software\Microsoft\Shell\CumulativeCallTimers characteristic allow call timers to be reset.

    • Parms in the Registry\HKLM\Security\WTLS characteristic identify the WTLS security settings. Possible values are: CipherSuites, KeyExchangeSuites, Certificates.

    • Parms in the Registry\HKLM\Software\Microsoft\Color characteristic update colors on the device using .tsk files.

    • Parms in the Registry\HKLM\Software\Microsoft\AirSync\Status characteristic set ActiveSync settings.

    • Parms in the Registry\HKLM\PMail\MessageStore characteristic set ActiveSync settings.

    • Parms in the Registry\HKLM\Ident characteristic set the name of the phone.

    • Parms in the Registry\HKCU\Software\Microsoft\Windows CE Services characteristic are used for RAPI access for creating a partnership.

    • Parms in the Registry\HKLM\Comm\SecurityProviders\SCHANNEL characteristic are used for RAPI access for creating a partnership.

    • Parms in the Registry\HKCU\SOFTWARE\Microsoft characteristic must be the same role masks as HKLM\software\microsoft.

    • Parms in the Registry\HKLM\Comm\ApplicationDownload\TrustedSources\Certificates\99A18FAF1CD77D4EED5305E0A3C2595F0D3D9D3E\Blob characteristic identify the CertificateStore Configuration Service Provider.

    • Parms in the Registry\HKLM\Comm\ApplicationDownload\TrustedSources\Certificates\B102B32BCA7D637231FC0B3C20E21C3AB576EB92\Blob characteristic identify the CertificateStore Configuration Service Provider.

    • Parms in the Registry\HKLM\Security\Policy\APIs\SIMMgr characteristic identify the Required Trust for accessing the SIM Manager APIs. The Required trust can be set at the granularity of individual Functions. In order to set the security of an individual SIM Manager Function so that it is different from the default, a child subkey must be created that is the same name as the function and set to the desired security level. The following table lists the possible values.

      Value Description
      0 OEM_CERTIFY_FALSE (Untrusted - No Trust Required)
      1 OEM_CERTIFY_RUN (User Trust Required)
      2 OEM_CERTIFY_TRUST (Kernel Trust Required)

    • Parms in the Registry\HKLM\Security\Policy\APIs\CPM characteristic identify the Required Trust for accessing Critical Process Monitor (CPM) APIs. The Required trust can be set at the granularity of individual Functions. In order to set the security of an individual CPM Function different from that of the default, a child subkey must be created that has the same name as the function and is set to the desired security level. The following table lists the possible values.

      Value Description
      0 OEM_CERTIFY_FALSE (Untrusted - No Trust Required)
      1 OEM_CERTIFY_RUN (User Trust Required)
      2 OEM_CERTIFY_TRUST (Kernel Trust Required)

    • Parms in the Registry\HKLM\Security\Policy\APIs\ConnAPI characteristic identify the Required Trust for accessing Connection Manager APIs. The Required trust for Connection Manager APIs can be set at the granularity of individual functions. To set the security for an individual SIM Manager function different than the default key, a child subkey must be created with the same name as the function and set to the desired security level. The following table lists the possible values.

      Value Description
      0 OEM_CERTIFY_FALSE (Untrusted - No Trust Required)
      1 OEM_CERTIFY_RUN (User Trust Required)
      2 OEM_CERTIFY_TRUST (Kernel Trust Required)

    • Parms in the Registry\HKLM\Security\Policy\APIs\ExTAPI characteristic identify the Required Trust for accessing Extended TAPI APIs. The Required trust can be set at the granularity of individual functions. To set the security for an individual Extended TAPI function's required Security different from the default, a child subkey must be created with the same name as the function and set to the desired security level. The following table lists the possible values.

      Value Description
      0 OEM_CERTIFY_FALSE (Untrusted - No Trust Required)
      1 OEM_CERTIFY_RUN (User Trust Required)
      2 OEM_CERTIFY_TRUST (Kernel Trust Required)

  • 0
    This parm is used in the following characteristics:

    • In the Registry\HKCU\Software\Microsoft\MessengerService\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 0.
    • In the Registry\HKCU\Software\Microsoft\Inbox\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 0.
    • In the Registry\HKCU\Software\Microsoft\Inbox\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 1.
    • In the Registry\HKCU\Software\Microsoft\MessengerService\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 1.

    The following table shows the default settings.

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

    AuthenticatedUser

  • 1
    This parm is used in the RegistryHKCU\ControlPanel\SoundCategories\Attentuation characteristic to identify the attenuation level for alerts played while in a call. The following table lists the possible values.

    Value Description
    0 Off
    1 1
    2 2
    3 3
    4 4
    5 5

    The following table shows the default settings.

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

    AuthenticatedUser

  • 2
    This parm is used in the following characteristics:

    • In the Registry\HKCU\Software\Microsoft\Inbox\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 2.
    • In the Registry\HKCU\Software\Microsoft\MessengerService\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 2.

    The following table shows the default settings.

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

    AuthenticatedUser

  • 3
    This parm is used in the following characteristics:

    • In the Registry\HKCU\Software\Microsoft\MessengerService\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 3.
    • In the Registry\HKCU\Software\Microsoft\Inbox\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 3.

    The following table shows the default settings.

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

    AuthenticatedUser

  • 4
    This parm is used in the following characteristics:

    • In the Registry\HKCU\Software\Microsoft\Inbox\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 4.
    • In the Registry\HKCU\Software\Microsoft\MessengerService\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 4.

    The following table shows the default settings.

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

    AuthenticatedUser

  • 5
    This parm is used in the following characteristics:

    • In the Registry\HKCU\Software\Microsoft\MessengerService\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 5.
    • In the Registry\HKCU\Software\Microsoft\Inbox\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 5.

    The following table shows the default settings.

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

    AuthenticatedUser

  • 6
    This parm is used in the following characteristics:

    • In the Registry\HKCU\Software\Microsoft\Inbox\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 6.
    • In the Registry\HKCU\Software\Microsoft\MessengerService\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 6.

    The following table shows the default settings.

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

    AuthenticatedUser

  • 7
    This parm is used in the following characteristics:

    • In the Registry\HKCU\Software\Microsoft\Inbox\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 7.
    • In the Registry\HKCU\Software\Microsoft\MessengerService\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 7.

    The following table shows the default settings.

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

    AuthenticatedUser

  • 8
    This parm is used in the Registry\HKCU\Software\Microsoft\MessengerService\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 8.

    The following table shows the default settings.

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

    AuthenticatedUser

  • 9
    This parm is used in the following characteristics:

    • In the Registry\HKCU\Software\Microsoft\MessengerService\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 9.
    • In the Registry\HKCU\Software\Microsoft\Inbox\PresetMsgs characteristic to identify the text displayed in the UI for predefined text option 9.

    The following table shows the default settings.

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

    AuthenticatedUser

  • ActiveProfile
    This parm is used in the Registry\HKCU\ControlPanel\Profiles characteristic to identify the profile that is currently active on the device.

    The following table shows the default settings.

    Permissions Read/write
    Data type String
    Label Active Profile:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • AddressCount
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to identify the number of lines on the phone.

  • AgeFilter
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\SyncServiceProviders\IMAP4 characteristic to identify the maximum number of days worth of mail to keep on the device.

    The following table shows the default settings.

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

    AuthenticatedUser

  • AllowCookies
    This parm is used in the Registry\HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings characteristic to identify whether or not cookies are allowed in Pocket Internet Explorer.

    The following table shows the default settings.

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

    AuthenticatedUser

  • AnyKey
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to determine whether or not the user can press any key to answer the phone.

    The following table shows the default settings.

    Permissions Read/write
    Data type Boolean
    Label Any key answer
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • AreaCode
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to identify the local area code.

  • AttachFetchSize
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\SyncServiceProviders\IMAP4 characteristic to identify the maximum number of bytes worth of attachments to automatically download when retrieving the full copy of a message.

    The following table shows the default settings.

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

    AuthenticatedUser

  • AttenuationCategory
    This parm is used in the Registry\HKCU\ControlPanel\SoundCategories characteristic.

    The following table shows the default settings.

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

    AuthenticatedUser

  • AutoAns
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to identify the auto answer timeout interval. The following table lists the possible values.

    Value Description
    2 2 seconds
    4 4 seconds
    6 6 seconds
    8 8 seconds
    10 10 seconds
    -1 Never

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label Auto-answer in:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • AutoCnct
    This parm is used in the Registry\HKCU\ControlPanel\Comm characteristic to automatically initiate ActiveSync.

    The following table shows the default settings.

    Permissions Read/write
    Data type Boolean
    Label Automatically start sync when connected using:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • AutoOff
    This parm is used in the Registry\HKCU\ControlPanel\Power characteristic to automatically turn the device on and off.

    The following table shows the default settings.

    Permissions Read/write
    Data type Boolean
    Label Automatically turn device off and on
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • AutoOffTime
    This parm is used in the Registry\HKCU\ControlPanel\Power characteristic to determine when the device will automatically turn off.

    The following table shows the default settings.

    Permissions Read/write
    Data type Time
    Label Auto off time:
    Semantic type short-date_time
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • AutoOnTime
    This parm is used in the Registry\HKCU\ControlPanel\Power characteristic to determine when the device will automatically turn on.

    The following table shows the default settings.

    Permissions Read/write
    Data type Time
    Label Auto on time:
    Semantic type short-date_time
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • autosave
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\Settings characteristic to identify the interval (in milliseconds) at which the Inbox auto-saves messages being composed into the drafts folder. If this parm is set to 0, autosave does not occur.

    The following table shows the default settings.

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

    AuthenticatedUser

  • AutoSyncMilliseconds
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\Settings characteristic to identify the interval (in milliseconds) at which auto-initiated syncs take place. If this parm is set to 0, no auto-initiated syncs occur.

    The following table shows the default settings.

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

    AuthenticatedUser

  • ModeGSM
    This parm is used in the Registry\HKCU\ControlPanel\Sounds\KeyPress characteristic to identify the beep mode for keypress sounds on a GSM phone. The following table lists the possible values.

    Value Description
    0 None
    1 Tone
    2 Click

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label Keypad control :
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • ModeCDMA
    This parm is used in the Registry\HKCU\ControlPanel\Sounds\KeyPress characteristic to identify the beep mode for keypress sounds on a CDMA phone. The following table lists the possible values.

    Value Description
    0 None
    1 Short tone
    2 Click
    3 Long tone

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label Keybpad control :
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • CacheLimit
    This parm is used in the Registry\HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\Cache\History characteristic to identify the maximum size of the history cache. The user cannot change this setting.

    The following table shows the default settings.

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

    AuthenticatedUser

  • CacheLimit
    This parm is used in the Registry\HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\Cache\Cookies characteristic to identify the maximum size of the cookie cache. The user cannot change this setting.

    The following table shows the default settings.

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

    AuthenticatedUser

  • CacheLimit
    This parm is used in the Registry\HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\Cache\Content characteristic to identify the maximum size of the content cache. This should be 1/3 of the RAM. The user cannot change this setting.

    The following table shows the default settings.

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

    AuthenticatedUser

  • CallHistoryMax
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to identify the maximum number of entries that can be stored in call history.

    The following table shows the default settings.

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

    AuthenticatedUser

  • CallProgressIdleTimeout
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to identify the number of milliseconds that call progress remains visible when there are no active, incoming, held, or outgoing calls.

    The following table shows the default settings.

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

  • Category
    This parm is used in the Registry\HKCU\ControlPanel\Sounds characteristic to identify the category for a sound. The category will be either ring, feedback, in call, or notification.

    The following table shows the default settings.

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

    AuthenticatedUser

  • CharTimeout
    This parm is used in the Registry\HKCU\ControlPanel\Accessibility characteristic to identify the character timeout interval. The following table lists the possible values.

    Value Description
    500 1/2 second
    1000 1 second
    1500 1 1/2 seconds
    2000 2 seconds
    -1 No auto advance

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label Multipress time out:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • ClearTypeText
    This parm is used in the Registry\HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings characteristic to identify whether or not cleartype text is enabled or disabled. The user cannot change this setting.

    The following table shows the default settings.

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

    AuthenticatedUser

  • CountryCode
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to identify the local country code.

  • CreateSpecialFolders
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\SyncServiceProviders\IMAP4 characteristic to determine whether or not special folders are created on the server if they do not already exist. The following table lists the possible values.

    Value Description
    True Special folders, such as "sent items" and "deleted items", are created on the server if they do not already exist.
    False Special folders, such as "sent items" and "deleted items", are not created on the server if they do not already exist.

    The following table shows the default settings.

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

    AuthenticatedUser

  • DaysToKeep
    This parm is used in the Registry\HKCU\Software\Microsoft\Internet Explorer\Main characteristic to identify the days to keep in Pocket Internet Explorer history.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Default
    This parm identifies the required trust for accessing APIs. The following table shows the possible values.

    Value Description
    0 OEM_CERTIFY_FALSE (Untrusted - No Trust Required)
    1 OEM_CERTIFY_RUN (User Trust Required)
    2 OEM_CERTIFY_TRUST (Kernel Trust Required)

    This parm is used in the following characteristics:

    • Registry\HKLM\Security\Policy\APIs\RILGSM characteristic to identify the Required Trust for accessing the Radio Interface Layer (RIL) APIs. All RIL APIs have the same Required Trust level as the default RIL Key. The following table lists the possible values.
    • This parm is used in the Registry\HKLM\Security\Policy\APIs\WAPDrv characteristic to identify the Required Trust for accessing the WAP Drivers (WTP, WTLS, and WDP). All WAP Driver APIs have the same Required Trust level as the default Key. The following table lists the possible values.
    • Registry\HKLM\Security\Policy\APIs\TSP characteristic to identify the Required Trust for accessing the TAPI Service Providers (TSP). All TSP APIs have the same Required Trust level as the default Key. The following table lists the possible values.
    • This parm is used in the Registry\HKLM\Security\Policy\APIs characteristic to identify the Required Trust for accessing the CellCore APIs, including CellCore Components. For example, CPM, Event Logger, RIL, Connection manager, SIM Toolkit, SIM Manager. Any specified subkeys override the Require Trust level of this Key. The following table lists the possible values.
    • Registry\HKLM\Security\Policy\APIs\ATCmdInt characteristic to identify the Required Trust for accessing the AT Command Interpreter (Wireless Data Link) (ATCI) APIs. All ATCI APIs have the same required trust level as the default key. The following table lists the possible values.
    • Registry\HKLM\Security\Policy\APIs\ELDrv characteristic to identify the Required Trust for accessing the Event Logger APIs. All Event Logger APIs have the Same Required Trust level as the default Key. The following table lists the possible values.
    • Registry\HKLM\Security\Policy\APIs\SIMTKit characteristic to identify the Required Trust for accessing the SIM Toolkit APIs. All SIM Toolkit APIs have the same Required Trust level as the default Key. The following table lists the possible values.

    The following table shows the default settings.

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

  • DefaultActiveProfile
    This parm is used in the Registry\HKCU\ControlPanel\Profiles characteristic to identify the Profile that is set as the default for the initial power on of the device.

    The following table shows the default settings.

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

    AuthenticatedUser

  • DefaultAddressID
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to identify the current outgoing line. The following table lists the possible values.

    Value Description
    0 1
    1 2

  • Default_CodePage
    This parm is used in the Registry\HKLM\SOFTWARE\Microsoft\Internet Explorer\International characteristic to identify the language encoding option.

    The following table shows the default settings.

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

    AuthenticatedUser

  • DefaultTPS
    This parm is used in the Registry\HKLM\Security\WAP\TPSList characteristic to identify the name of the Trusted Provisioning Server.

    The following table shows the default settings.

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

    Operator - TPS

    Manager

  • DialMonitored
    This parm is used in the Registry\HKCU\Software\Microsoft\VMail characteristic to enable the voice mail indicator to be cleared when the user dials the voice mail number. By default, the voice mail indicator is not cleared when the user dials the voice mail number. However, setting this parm to a non-zero value enables the voice mail indicator to be automatically cleared when the user dials the voice mail number. By default, the indicator is cleared when the mobile operator sends the "clear voice mail indicator" SMS message to the device.

    The following table shows the default settings.

    Permissions Read/write
    Data type Boolean
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

  • Directory
    This parm is used in the Registry\HKCU\ControlPanel\SoundCategories characteristic to identify the directory where the sound files for this category of sound reside.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Display
    This parm is used in the Registry\HKCU\ControlPanel\Power characteristic to display timeout values. The following table lists the possible values.

    Value Description
    -1 Never
    600000 10 minutes
    1800000 30 minutes
    3600000 1 hour
    7200000 2 hours
    14400000 4 hours
    28800000 8 hours

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label Display time out:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Display Inline Images
    This parm is used in the Registry\HKCU\Software\Microsoft\Internet Explorer\Main characteristic to identify whether or not to display images on Web pages in Pocket Internet Explorer.

    The following table shows the default settings.

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

    AuthenticatedUser

  • E-mail
    This parm is used in the Registry\HKCU\ControlPanel\Owner characteristic to hold the e-mail address of the owner of the phone.

    The following table shows the default settings.

    Permissions Read/write
    Data type String
    Label E-mail address:
    Semantic type email
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • EnableAutoDetect
    This parm is used in the Registry\HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings characteristic to identify whether or not autodetect is enabled in Pocket Internet Explorer options.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Enabled
    This parm is used in the Registry\HKCU\Software\Microsoft\AirSync\Logging characteristic to set the logging mode for server sync. This parm reflects the Setting UI. The following table lists the possible values.

    Label Value
    None 0
    Brief 1
    Verbose 2

    The following table shows the default settings.

    Permissions Read/write
    Data type Boolean
    Label Logging:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • EnableWarning0
    This parm is used in the Registry\HKCU\Software\Microsoft\Internet Explorer\Main characteristic to identify whether or not security warnings are enabled. Default is ON. 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 Integer
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • EnableWarning1
    This parm is used in the Registry\HKCU\Software\Microsoft\Internet Explorer\Main characteristic to identify whether or not security warning 1 is enabled. Default is ON. 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 Integer
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • FetchSize
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\SyncServiceProviders\IMAP4 characteristic to identify the maximum number of bytes worth of a mail message to download when doing the initial partial download of a mail message.

    The following table shows the default settings.

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

    AuthenticatedUser

  • FontSize
    This parm is used in the Registry\HKCU\ControlPanel\Accessibility characteristic to identify the font size. The following table lists the possible values.

    Value Description
    1 Normal
    2 Large

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label System font size:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • HScore
    This parm is used in the Registry\HKLM\Software\Microsoft\Nibbles characteristic to identify the current high score in Nibbles.

    The following table shows the default settings.

    Permissions Read Only
    Data type Integer
    Label High score:
    Roles allowed to query and update setting Manager

  • IncludeOriginal
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\Settings characteristic to determine whether or not the original message is included in the reply for e-mail messages. This has no effect on SMS messages. SMS messages never include the original on reply. The following table lists the possible values.

    Value Description
    True The original message is included in the reply for e-mail messages.
    False The original message is not included in the reply for e-mail messages.

    The following table shows the default settings.

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

    AuthenticatedUser

  • IncludeRemoteSync
    This parm is used in the Registry\HKCU\Software\Microsoft\AirSync\Settings characteristic to identify whether or not to include the remote sync option for activesync.

    The following table shows the default settings.

    Permissions Read/write
    Data type Boolean
    Label Include PC sync remotely when synchronizing
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • InitialOrder
    This parm is used in the Registry\HKCU\Software\Microsoft\Shell\StartMRU characteristic. This parm is the MULTI_SZ that contains the applications that are placed in the MRU on initial device boot. Each SZ entry is the full path to the application's .lnk file, for example "\\windows\\start menu\\calendar.lnk". The entries should be in the reverse order of how they will appear in the MRU

    The following table shows the default settings.

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

  • InitVol
    This parm is used in the Registry\HKCU\ControlPanel\SoundCategories characteristic to identify the starting volume for the sound when played.

    The following table lists the possible values.

    Value Description
    0 Off
    1 1
    2 2
    3 3
    4 4
    5 Loud

    This parm is used in the following characteristics:

    • Registry\HKCU\ControlPanel\SoundCategories\Reminder characteristic to identify the initial volume for Reminder sounds. In addition to the default settings shown in the table below, this parm has an Reminder type: label.
    • Registry\HKCU\ControlPanel\SoundCategories\Alarm characteristic to identify the initial volume for Alarm sounds. In addition to the default settings shown in the table below, this parm has an Alarm volume: label.
    • Registry\HKCU\ControlPanel\SoundCategories\InCall characteristic to identify the initial volume for incoming call sounds.
    • Registry\HKCU\ControlPanel\SoundCategories\Ring characteristic to identify the initial volume for ring sounds. The following table lists the possible values.
    • Registry\HKCU\ControlPanel\SoundCategories\System to identify the initial volume for feedback sounds. The following table lists the possible values.
    • Registry\HKCU\ControlPanel\SoundCategories\Notification characteristic to identify the initial volume for notification sounds. The following table lists the possible values.

    The following table shows the default settings.

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

    AuthenticatedUser

  • LockTimeout
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to identify the timeout interval for a device password lock. The following table lists the possible values.

    Value Description
    60000 1 minute
    120000 2 minutes
    300000 5 minutes
    600000 10 minutes
    1800000 30 minutes
    3600000 60 minutes

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label Lock phone after:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • MaxDeletedMsgs
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\SMSText characteristic to identify the maximum number of deleted SMS messages that can be kept in the deleted items folder at a time. Default is 50.

    The following table shows the default settings.

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

  • Name
    This parm is used in the Registry\HKCU\ControlPanel\Profiles\Car characteristic to identify the name of a profile.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Name:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Name
    This parm is used in the Registry\HKCU\ControlPanel\Owner characteristic to hold the name of the owner of the phone.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Name
    This parm is used in the Registry\HKCU\ControlPanel\Profiles\Loud characteristic to identify the name of a profile.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Name:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Name
    This parm is used in the Registry\HKCU\ControlPanel\Profiles\Meeting characteristic to identify the name of a profile.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Name:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Name
    This parm is used in the Registry\HKCU\ControlPanel\Profiles\Silent characteristic to identify the name of a profile.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Name:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

    Operator -- TPS

  • Name
    This parm is used in the Registry\HKCU\ControlPanel\Profiles\Normal characteristic to identify the name of the profile.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Name:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Notes
    This parm is used in the Registry\HKCU\ControlPanel\Owner characteristic to hold the notes for the owner of the phone.

    The following table shows the default settings.

    Permissions Read/write
    Data type String
    Label Notes:
    Semantic type text
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • NumberOfLogs
    This parm is used in the Registry\HKCU\Software\Microsoft\AirSync\Logging characteristic to identify the number of server sync logs to store on the device.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Order
    This parm is used in the Registry**\HKCU\Software\Microsoft\Shell\StartMenu** characteristic. This parm is the MULTI_SZ that lists, in order, the special applications to bump to the top of the programs list. For example, "Inbox.lnk", "Contacts.lnk", "Calendar.lnk", and "Internet Explorer.lnk"

    The following table shows the default settings.

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

  • PhoneNumber1
    This parm is used in the Registry\HKCU\Software\Microsoft\Vmail characteristic to identify the voice mail number for line 1.

    The following table shows the default settings.

    Permissions Read/write
    Data type String
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • PhoneNumber2
    This parm is used in the Registry\HKCU\Software\Microsoft\Vmail characteristic to identify the voice mail number for line 2.

    The following table shows the default settings.

    Permissions Read/write
    Data type String
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • Play_Background_Sounds
    This parm is used in the Registry\HKCU\Software\Microsoft\Internet Explorer\Main characteristic to identify whether or not to playback background sounds. Default is OFF. The user can change the setting in Pocket Internet Explorer options. 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 Integer
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • PlusConversion
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to determine whether or not speed dial entries can end in 0. If this parm is set, speed dial entries cannot end in 0.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Priority
    This parm is used in the following characteristics:

    • Registry\HKCU\Software\Microsoft\SMS\Protocols\Raw characteristic to determine the priority of Raw SMS message types.
    • Registry\HKCU\Software\Microsoft\SMS\Protocols\Broadcast characteristic to determine the priority of SMS Broadcast message type providers.

    The following table shows the default settings.

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

  • ReadHTMLMail
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\Settings characteristic to determine whether or not messaging attempts to decode HTML-only messages using Pocket Internet Explorer for display in plain text. The following table lists the possible values.

    Value Description
    True Messaging attempts to decode HTML-only messages using Pocket Internet Explorer for display in plain text.
    False Messaging does not attempt to decode HTML-only messages using Pocket Internet Explorer for display in plain text.

    The following table shows the default settings.

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

    AuthenticatedUser

  • RegOverridesSIM
    This parm is used in the Registry\HKCU\Software\Microsoft\Vmail characteristic to determine whether or not the SIM voice mail numbers override the registry voice mail numbers. The following table lists the possible values.

    Value Description
    True The voice mail numbers stored in the registry override the voice mail numbers stored on the SIM.
    False The voice mail numbers stored on the SIM override the voice mail numbers stored in the registry.

    The following table shows the default settings.

    Permissions Read/write
    Data type Boolean
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

  • SaveSent
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\Settings characteristic to determine whether or not a copy of each sent message is placed in the "Sent Items" folder on the device. The following table lists the possible values.

    Value Description
    True A copy of each sent message is placed in the "Sent Items" folder on the device.
    False A copy of each sent message is not placed in the "Sent Items" folder on the device.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Script
    This parm is used in the Registry\HKCU\ControlPanel\Sounds characteristic to identify the method for playing a sound. The following table lists the possible values.

    Value Description
    v vibrate
    l loop
    p play
    p3 play three seconds

    The following table shows the default settings.

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

    AuthenticatedUser

  • Script
    This parm is used in the Registry\HKCU\ControlPanel\Sounds characteristic to identify the script that determines how a ring is played. The following table lists the possible values.

    Value Description
    apw3r Ring
    p Ring once
    s2apw3c150r Increasing ring
    av3w3r Vibrate
    v3w3apw3r Vibrate then ring
    a Silent

    The following table shows the default settings.

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

    AuthenticatedUser

  • Script
    This parm is used in the Registry\HKCU\ControlPanel\Sounds\KeyPress characteristic to identify the script for keypress sounds.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Script
    This parm is used in the Registry\HKCU\ControlPanel\SoundCategories\Notification characteristic to identify the script that determines how notifications are played. The following table lists the possible values.

    Value Description
    p Play sound
    v3 Vibrate
    v3w3p Vibrate then sound

    The following table shows the default settings.

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

    AuthenticatedUser

  • Secure
    This parm is used in the Registry\HKCU\Software\Microsoft\AirSync\Connection characteristic to determine whether or not the device validates a server certificate.

    The following table shows the default settings.

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

    AuthenticatedUser

  • SHBoxTimeout
    This parm is used in the Registry\HKCU\ControlPanel\Accessibility characteristic to identify the timeout interval for events and confirmations, such as SHBox or SIM Toolkit UI. The following table lists the possible values.

    Value Description
    5000 5 seconds
    10000 10 seconds
    20000 20 seconds
    0 None

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label Confirmation time out:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • ShowDateTime
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\Settings characteristic to determine whether or not the date and time are shown for each message in the list view. The following table lists the possible values.

    Value Description
    True The date and time is shown for each message in the list view.
    False The date and time is not shown for each message in the list view.

    The following table shows the default settings.

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

    AuthenticatedUser

  • ShowSIM
    This parm is used in the Registry\HKCU\ControlPanel\Phone characteristic to determine whether or not SIM phonebook entries are automatically filtered.

    The following table shows the default settings.

    Permissions Read/write
    Data type Boolean
    Label Allow Auto Filter of SIM phonebook entries
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • SignalLevelHighFloor
    This parm is used in the Registry\HKLM\Software\Microsoft\ssupdate characteristic. The value is used for determining whether the signal strength is "Medium". This must be a number between 0 and 100. Any signal strength lower than this but higher than or equal to SignalLevelMedFloor will show as 2 bars in the user interface. Signal strength higher than or equal to SignalLevelHighFloor and smaller than 100 will show as 3 bars. Signal strength greater than 100 always shows as 4 bars.

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

  • SignalLevelLowFloor
    This parm is used in the Registry\HKLM\Software\Microsoft\ssupdate characteristic. The value is used for determining whether the signal strength is "Very Low". This must be a number between 0 and 100. Any signal strength lower than this will show as 0 bars in the user interface.

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

  • SignalLevelMedFloor
    This parm is used in the Registry\HKLM\Software\Microsoft\ssupdate characteristic. The value is used for determining whether the signal strength is "Low". This must be a number between 0 and 100. Any signal strength lower than this but higher than or equal to SignalLevelLowFloor will show as 1 bar in the user interface.

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

  • Size
    This parm is used in the Registry\HKLM\Software\Microsoft\Nibbles characteristic to determine the board size for Nibbles. The following table lists the possible values.

    Value Description
    4 Small
    8 Medium
    12 Large

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label Board size:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • SMSUnicode
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\Settings characteristic to determine the encoding used for sending SMS messages. The following table lists the possible values.

    Value Description
    True SMS messages are sent using Unicode encoding.
    False SMS message are sent using GSM encoding.

    The following table shows the default settings.

    Permissions Read/write
    Data type Boolean
    Roles allowed to query and update setting Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • SortOrder
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\Settings characteristic to identify the sort order for list views in messaging.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Sound
    This parm is used in the Registry\HKCU\ControlPanel\Sounds characteristic to identify the name of a sound file. This does not include the directory, it is just the file name. For example, "ring.wav".

    The following table shows the default settings.

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

    AuthenticatedUser

    UnauthenticatedUser

  • Speed
    This parm is used in the Registry\HKLM\Software\Microsoft\Nibbles characteristic to determine the game speed for Nibbles.

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label Game speed:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Start Page
    This parm is used in the Registry\HKCU\Software\Microsoft\Internet Explorer\Main characteristic to identify the default homepage URL.

    The following table shows the default settings.

    Permissions Read/write
    Data type String
    Semantic type url
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Telephone
    This parm is used in the Registry\HKCU\ControlPanel\Owner characteristic to hold the phone number of the owner of the phone.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Timeout
    This parm is used in the Registry\HKCU\ControlPanel\Home characteristic to identify the timeout interval for the home screen. The following table lists the possible values.

    Value Description
    -1 Never
    10000 After 10 seconds
    300000 After 5 minutes
    600000 After 10 minutes
    900000 After 15 minutes
    1800000 After 30 minutes

    The following table shows the default settings.

    Permissions Read/write
    Data type Integer
    Label Time out:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • TrashMoves
    This parm is used in the Registry\HKCU\Software\Microsoft\Inbox\SyncServiceProviders\IMAP4 characteristic to determine whether or not deleted items are placed in the deleted items folder on the server. The following table lists the possible values.

    Value Description
    True Deleted items are placed in the deleted items folder on the server.
    False Deleted items are not placed in the deleted items folder on the server.

    The following table shows the default settings.

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

    AuthenticatedUser

  • UrlPrefix
    This parm is used in the Registry\HKLM\SOFTWARE\Microsoft\Internet Explorer\URL characteristic to identify the prefix that is automatically added to a URL in the Pocket Internet Explorer address bar. Default is www.

    The following table shows the default settings.

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

    AuthenticatedUser

  • UrlSuffix
    This parm is used in the Registry\HKLM\SOFTWARE\Microsoft\Internet Explorer\URL characteristic to identify the suffix that is automatically added to a URL in the Pocket Internet Explorer address bar. The default is com.

    The following table shows the default settings.

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

    AuthenticatedUser

  • WindowSize
    This parm is used in the Registry\HKCU\Software\Microsoft\AirSync\Settings characteristic to identify the window size - the number of items brought down in each sync window.

    The following table shows the default settings.

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

    AuthenticatedUser

  • XML
    This parm is used in the following characteristics:

    • Registry\HKCU\ControlPanel\Profiles\Normal\Items characteristic to contain the XML blob that defines the settings for the Normal profile.
    • Registry\HKCU\ControlPanel\Profiles\Silent\Items characteristic to contain the XML blob that defines the settings for the Silent profile.
    • Registry\HKCU\ControlPanel\Profiles\Meeting\Items characteristic to contain the XML blob that defines the settings for the Meeting profile.
    • Registry\HKCU\ControlPanel\Profiles\Loud\Items characteristic to contain the XML blob that defines the settings for the Loud profile.
    • Registry\HKCU\ControlPanel\Profiles\Car\Items characteristic to contain the XML blob that defines the settings for the Car profile.
    • Registry\HKCU\ControlPanel\Profiles\Radio Off\Items characteristic to contain the XML blob that defines the settings for the Radio Off profile

    The following table shows the default settings.

    Permissions Read/write
    Data type String
    Label Profile Items
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • ZoomSetting
    This parm is used in the Registry\HKCU\Software\Microsoft\Internet Explorer\Main characteristic to identify the font size. The user cannot change this setting.

    The following table shows the default settings.

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

    AuthenticatedUser

Elements

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

Recursive query:Yes

Top level query: No

For information about specific elements, see MSPROV DTD Elements.

See Also

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

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.