Metabase Configuration Service Provider
Use the Metabase Configuration Service Provider to add, modify, and remove entries from the metabase.
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.
The metabase (metadata database) contains specific information about the Configuration Service Providers on a Windows Mobile-based device. The metadata includes settings, possible values, information about how to display parameters that are configurable through certain Configuration Service Providers, role requirements and mappings for each setting and Configuration Service Provider, and other relevant information about them. Individual settings can be queried, updated, or deleted; however, top-level query and deletion is not supported.
Each Configuration Service Provider setting is updated as a metabase configuration file is processed. This allows new setting values in subsequent settings within the file to be used. For example, a security setting could be changed so that the next parm could make use of the new security role information.
The Metabase Configuration Service Provider also supports the <language code> parm, which allows localized text to be used on the device.
The following table shows the default settings for all parms in this Configuration Service Provider.
Permissions | Read/write |
Roles allowed to query and update setting | Manager |
Characteristics
- label
Provides user-friendly language labels in the user interface. - options
Groups option values that are available for this specific entry in different languages.
Parms
<language code>
This parm is used in the label characteristic to identify the text for the label in a specific language, and in the option characteristic to identify the code for that language. The following table lists the possible hexadecimal values for this parm.Value Description 0001 Arabic 0004 Chinese 0009 English 0401 Arabic (Saudi Arabia) 0402 Bulgarian 0403 Catalan 0404 Chinese (Taiwan) 0405 Czech 0406 Danish 0407 German (Germany) 0408 Greek 0409 English (United States) 040A Spanish (Traditional Sort) 040B Finnish 040C French (France) 040D Hebrew 040E Hungarian 040F Icelandic 0410 Italian (Italy) 0411 Japanese 0412 Korean 0413 Dutch (Netherlands) 0414 Norwegian (Bokmal) 0415 Polish 1416 Portuguese (Brazil) 0417 Rhaeto-Romanic 0418 Romanian 0419 Russian 041A Croatian 041B Slovak 041C Albanian 041D Swedish 041E Thai 041F Turkish 0420 Urdu 0421 Indonesian 0422 Ukrainian 0423 Belarusian 0424 Slovenian 0425 Estonian 0426 Latvian 0427 Lithuanian 0429 Farsi 042A Vietnamese 042D Basque 042E Sorbian 042F Macedonian (FYROM) 0430 Sutu 0431 Tsonga 0432 Tswana 0434 Xhosa 0435 Zulu 0436 Afrikaans 0438 Faeroese 0439 Hindi 043A Maltese 043C Gaelic 043D Yiddish 043E Malay (Malaysia) 0801 Arabic (Iraq) 0804 Chinese (PRC) 0807 German (Switzerland) 0809 English (United Kingdom) 080A Spanish (Mexico) 080C French (Belgium) 0810 Italian (Switzerland) 0813 Dutch (Belgium) 0814 Norwegian (Nynorsk) 0816 Portuguese (Portugal) 0818 Romanian (Moldova) 0819 Russian (Moldova) 081A Serbian (Latin) 081D Swedish (Finland) 0C01 Arabic (Egypt) 0C04 Chinese (Hong Kong SAR) 0C07 German (Austria) 0C09 English (Australia) 0C0A Spanish (International Sort) 0C0C French (Canada) 0C1A Serbian (Cyrillic) 1001 Arabic (Libya) 1004 Chinese (Singapore) 1007 German (Luxembourg) 1009 English (Canada) 100A Spanish (Guatemala) 100C French (Switzerland) 1401 Arabic (Algeria) 1407 German (Liechtenstein) 1409 English (New Zealand) 140A Spanish (Costa Rica) 140C French (Luxembourg) 1801 Arabic (Morocco) 1809 English (Ireland) 180A Spanish (Panama) 1C01 Arabic (Tunisia) 1C09 English (South Africa) 1C0A Spanish (Dominican Republic) 2001 Arabic (Oman) 2009 English (Jamaica) 200A Spanish (Venezuela) 2401 Arabic (Yemen) 240A Spanish (Colombia) 2801 Arabic (Syria) 2809 English (Belize) 280A Spanish (Peru) 2C01 Arabic (Jordan) 2C09 English (Trinidad) 2C0A Spanish (Argentina) 3001 Arabic (Lebanon) 300A Spanish (Ecuador) 3401 Arabic (Kuwait) 340A Spanish (Chile) 3801 Arabic (U.A.E.) 380A Spanish (Uruguay) 3C01 Arabic (Bahrain) 3C0A Spanish (Paraguay) 4001 Arabic (Qatar) 400A Spanish (Bolivia) 440A Spanish (El Salvador) 480A Spanish (Honduras) 4C0A Spanish (Nicaragua) 500A Spanish (Puerto Rico) access-role
This parm is used with the label and options characteristics as a decimal value that identifies access roles. Access roles determine which security roles are allowed to access a metabase entry. Each access role is a number formed by a bitwise or from the security roles that have access to the entry. More than one role can be set for the entry. This parm cannot be used directly under the root characteristic. The following is the list of possible security roles and corresponding role values:Role Dec Value Description SECROLE_MANAGER 8 The manager role is used for management operations on the Smartphone. It holds the highest level of authority. SECROLE_OEM 2 Equipment Manufacturer role. SECROLE_Operator 4 Mobile Operator role. SECROLE_OPERATOR TPS 128 Trusted Provisioning Server role is assigned to WAP messages from a Push Initiator authenticated (PPG_AUTH) by a trusted Push Proxy Gateway (TRUSTED_PPG). The Push Initiator's URI corresponds to the device's TPS URI. SECROLE_PPG_TRUSTED 2048 Messages signed using this role indicate that the content sent by the Push Initiator is trusted by the Push Proxy Gateway. This role implies that the Push Proxy Gateway is trusted by the device (TRUSTED_PPG). SECROLE_PPG_AUTH 1024 Messages signed using this role indicate that the Push Initiator is authenticated by the Push Proxy Gateway. This role implies that the Push Proxy Gateway is trusted by the device (TRUSTED_PPG). SECROLE_TRUSTED_PPG 512 Messages signed using this role indicate that the Push Proxy Gateway is known and trusted by the device. Note: Since WAP secure push is not supported, the Push Proxy Gateway is not currently authenticated. The PPG's address is only compared with the device's stored trusted PPG address.
SECROLE_KNOWN_PPG 256 Messages signed using this role indicate that the Push Proxy Gateway is known by the device. SECROLE_USER_AUTH 16 User Authenticated role is assigned to the following types of messages: - User pin-signed messages.
- Requests sent from phone's user control panel.
SECROLE_USER_UNAUTH 64 Non WAP-signed OTA messages are assigned this role. SECROLE_NONE 0 No role assignment. datatype
This parm is used with the label and options characteristics to identify the type of data handled by this setting. This parm cannot be used directly under the root characteristic. The following table lists the possible values.Value Description Integer The setting contains an integer value. String The setting contains a string value. Float The setting contains a floating point value. Date The setting contains a date. Time The setting contains a time. Boolean The setting contains a boolean value. Binary The setting contains a stream of binary data (octet stream). Multiplestring The setting contains a multiplestring value. maxlength
This parm is used with the local and options characteristics to represent the maximum number of characters the value of this parameter may have. This parm cannot be used directly under the root characteristic.maxvalue
This parm is used with the label and options characteristics to identify the maximum value for the entry. This parm cannot be used directly under the root characteristic.minvalue
This parm is used with the label and options characteristics to identify the minimum value for the entry. This parm cannot be used directly under the root characteristic.multiple
This parm is used with the local and options characteristics to specify whether the user is allowed to select multiple options. This parm cannot be used directly under the root characteristic. The following table lists the possible values.Value Description 0 The user is not allowed to select multiple options 1 The user is allowed to select multiple options. If there are no options specified or if the control specified does not allow multi-select, then this parm is ignored. If there are multiple values in the value attribute, this parm is also set to 1.
rw-access
This parm is used with the local and options characteristics to identify the role(s) with Read/Write access to the entry. This parm cannot be used directly under the root characteristic. The following table lists the possible values.Value Description 1 Read-only 2 Write-only 3 Read/Write semantic-type
This parm is used with the local and options characteristics. It allows the UI to provide a specialized control to better match the actual semantic type of the setting. The value of this attribute is not confined to a list. This parm cannot be used directly under the root characteristic. Some of the values used by UI control are as follows: email, alphanumeric-password, numeric-password, currency, url, file, text, phone-number, invisible.
Elements
Elements | Available |
---|---|
parm-query | Yes |
noparm | Yes |
nocharacteristic | Yes
Top level: No |
characteristic-query | Yes
Recursive: Yes Top level: No |
For information about specific elements, see MSPROV DTD Elements.
See Also
Configuration Service Provider Reference for Windows Mobile Devices| Metabase Configuration Service Provider Examples | Metabase Settings
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.