Platform Builder for Microsoft Windows CE 5.0 WinInet Registry Settings Send Feedback The registry stores information necessary to configure the system for applications and hardware devices. The registry also contains information that the operating system continually references during operation. The following registry settings are the default values. Note The default registry values vary depending on which Catalog items are included in your OS design. For more information, see Default Registry Settings.

Authentication support settings For authentication support, add a subkey to the registry under the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Security key, specifying the authentication scheme, for example, kerberos. A string value, DLLFile, should contain the name of the DLL that supports the authentication scheme. A DWORD value, Flags, should be set with the appropriate value. The following table shows the possible settings for the Flags value. Flag value Description PLUGIN_AUTH_FLAGS_UNIQUE_CON Each TCP/IP socket contains a different context. TEXT_PER_TCPIP (value=0x01) Otherwise, a new context is passed for each realm or block URL template. PLUGIN_AUTH_FLAGS_CAN_HANDLE This DLL can handle its own user input. _UI (value=0x02) PLUGIN_AUTH_FLAGS_CAN_HANDLE This DLL might be capable of doing an _NO_PASSWD (value=0x04) authentication without prompting the user for a password. PLUGIN_AUTH_FLAGS_NO_REALM This DLL does not use a standard HTTP realm string. (value=0x08) Any data that appears to be a realm is schemespecific. PLUGIN_AUTH_FLAGS_KEEP_ALIVE_ This DLL does not require a persistent connection for NOT_REQUIRED (value=0x10) its challenge-response sequence. The following settings in the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Security\Kerberos registry subkey enable Kerberos authentication. Value : type Description SecurityName : REG_SZ "Kerberos Authentication" DLLFile : REG_SZ "wininet.dll" SchemeList : REG_SZ "Kerberos" Flags : REG_DWORD 0x00,0x00,0x00,0x00 The following settings in the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Security\Basic registry key enable Basic authentication. Value : type Description SecurityName : REG_SZ "Basic Authentication" DLLFile : REG_SZ "wininet.dll" SchemeList : REG_SZ "Basic" Flags : REG_DWORD 0x00,0x00,0x00,0x00 The following registry settings enable NTLM authentication support in the

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Security\NTLM registry key: Value : type Description SecurityName : REG_SZ "NTLM SSPI Authentication" DLLFile : REG_SZ "ntlmssp.dll" SchemeList : REG_SZ "NTLM" Flags : REG_DWORD 0x08,0x00,0x00,0x00 The following registry settings enable NTLM authentication support in the HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings registry key. Value : type EnableNegotiate : REG_DWORD

Description Default setting is 0, which indicates that NTLM is used without negotiation. Set to 1 to enable Kerberos authentication. Default setting is 1. Default setting is 1. The dynamic link library that contains customized dialog boxes. If this value present, the required setting is "wininetui.dll".

EnableHttp1_1 : REG_DWORD ProxyHttp1.1 : REG_DWORD ReplaceableUIModule : REG_SZ

The following registry settings under the HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings registry key can be used to configure HTTP username and password. Value : type DisableUserPswdForHTTP ; REG_DWORD

Description Default value is 1 that disables username and password in the URL. Security Note Setting this value to 0 is not recommended because it enables username and password in the URL. This may expose the device to potential security threats.

Cache configuration settings The following setting in the HKEY_CURRENT_USER\SOFTWARE\Microsoft\windows\CurrentVersion\Internet Settings\ registry key specifies when the browser should check for updated Web pages. Value : type SyncMode5 : REG_DWORD

Description Default value is 00000004, which instructs the browser to automatically check for updated Web pages. Other valid values are: 0: Never check for updates (always use cached page). 2: Check for updates once per session. 3: Always check for updates.

Cache path settings The following settings in the HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders registry key define cache paths. Note On a per-user cache system, the UserName (value of HKEY_LOCAL_MACHINE\Ident key) is part of the cache path. Value : type Cache : REG_SZ

Description

The default path is \\Windows\\Profiles\\guest\\Temporary Internet Files. Cookies : REG_SZ The default path is \\Windows\\Profiles\\guest\\Cookies. History : REG_SZ The default path is \\Windows\\Profiles\\guest\\History. Note When Pocket Internet Explorer starts to run it will assume that the cache folder is a system folder and make it hidden.

Cache size limit settings The following settings in the HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\5.0\Cache registry key and subkeys specify initial cache limits, in kilobytes. [Subkey\]Value : type Signature : REG_SZ QuotaAdjustCheck : REG_DWORD

Content\CachePrefix : REG_SZ Content\CacheLimit : REG_DWORD Cookies\CachePrefix : REG_SZ Cookies\CacheLimit : REG_DWORD History\CachePrefix : REG_SZ History\CacheLimit : REG_DWORD

Description "Client UrlCache MMF Ver 4.7" Default setting is 00000001, which represents the minimum cache size of 256 KB. If this entry is not in the registry, the initial cache limit is 8192 KB. "Content:" Default setting is 00000200, which represents a cache size of 512 KB. "Cookie:" Default setting is 00000100, which represents a cache size of 256 KB. "Visited:" Default setting is 00000100, which represents a cache size of 256 KB.

Internet Protocol Settings The following settings in the HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\URL\Prefixes registry specify default Internet protocols to use when the user has not specified one. Value : type Description ftp : REG_SZ "ftp://" home : REG_SZ "http://"

www : REG_SZ "http://"

Network settings The following setting in the HKEY_CURRENT_USER\SOFTWARE\Microsoft\windows\CurrentVersion\Internet Settings\ registry key specifies how the browser should connect to the Internet. Value : type EnableAutodial : REG_DWORD

Description Set to 0 to connect to the Internet over a LAN by default.

Privacy Settings Privacy settings are stored according to the security zone and are located under the HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Zones\ key. The key is the security zone identifier — 1, 2, 3, or 4 — that represents Local intranet, Trusted sites, Internet, and Restricted sites, respectively. Privacy templates for the Internet zone correspond to the Medium privacy level and privacy templates for the Restricted sites zone correspond to Block All Cookies level. Templates for Local intranet and Trusted sites zones are not specified. The following setting in the key specifies the use of P3P policy. Value : type 1A10 : REG_DWORD

Description Determines how P3P policy evaluation is performed. It can be set to one of the following values:  



0 (URLPOLICY_ALLOW) - Accepts all cookies. Default value for Local intranet and Trusted sites. 1 (URLPOLICY_QUERY) - Cookie action is determined by evaluating the P3P policy against the restrictions imposed by the corresponding privacy template. Default value for the Internet zone. 3 (URLPOLICY_DISALLOW) - Rejects all cookies. Default value for the Restricted zone.

If this value is not set, then cookies are rejected. A binary representation of a privacy template for first-party cookies is stored as a value of {AEBA21FA-782A-4A90-978D-B72164C80120}. For third-party cookies, it is stored as a value of {A8A88C49-5EB2-4990-A1A2-0876022C854F}. If a security zone does not have privacy template data in the registry or the registry data cannot be converted to a properly formatted privacy template then the default behavior for this zone is to accept and send all cookies. For more information about P3P, see Platform for Privacy Preferences (P3P).

Advanced and Custom Privacy Templates Advanced privacy templates are stored under the HKEY_CURRENT_USER\SOFTWARE\Microsoft\windows\CurrentVersion\Internet Settings key. The following value in the Internet Settings key determines if an advanced or a custom template is used.

Value : type PrivacyAdvanced: REG_DWORD

Description Determines whether advanced or custom settings are applied in the Advanced Privacy Settings dialog box. It can be set to one of the following values:  

0 - Advanced or custom settings are not applied. 1 - Advanced or custom settings are applied.

Per Site Cookie Handling To handle site-by-site cookies, per-domain cookie decisions are stored under the HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\P3P\History\ key. The domains are added to the registry by WinInet when the user adds sites by using the Per Site Privacy Actions dialog box. The default value of the key stores the decision value. The following table shows the possible values. Value Description REG_DWORD: 1 (COOKIE_STATE_ACCEPT) Accept all cookies from this site. REG_DWORD: 5 (COOKIE_STATE_REJECT) Reject all cookies from this site. Note The site settings can be modified by using the Internet Options in the control panel or by using the Privacy Functions.

Proxy settings The following setting in the HKEY_CURRENT_USER\SOFTWARE\Microsoft\windows\CurrentVersion\Internet Settings\Connections registry key specifies the proxy settings. Value : type Description DefaultConnectionSettings: Use the proxy settings for your network. REG_BINARY To set and retrieve proxy settings in the registry, use the InternetSetOption and InternetQueryOption WinInet functions, respectively. The following list shows the parameter values to pass:    

hInternet, pass NULL to set the proxy settings for all sessions. This writes to the registry. dwOption, set to INTERNET_OPTION_PROXY. lpBuffer, point to the structure of type INTERNET_OPTION_PROXY. This is defined in wininet.h. dwBufferLength, set to the size of INTERNET_OPTION_PROXY.

InternetQueryOption retrieves proxy setting in lpBuffer.

User Agent settings The following settings in the HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Internet Settings key and subkeys specify information about the Internet client.

Value \5.0\User Agent\Version : REG_SZ \5.0\User Agent\Pre Platform \5.0\User Agent\Post Platform Platform : REG_SZ UA-Language : REG_SZ MinorVersion : REG_SZ

Description "MSIE 5.5" Enter additional information about your OS design in this subkey. Enter additional information about the Internet client, such as browser screen size, in this subkey. "Windows CE" "JavaScript" "CE.NET"

WinInet Debug Engine Settings The following settings in the HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Debug key specify debug controls for the WinInet debug engine. Value WininetError : REG_SZ WininetControl : REG_SZ WininetCategory : REG_SZ WininetBreak : REG_SZ WininetLogIndent : REG_SZ WininetLogFile : REG_SZ WininetDebugging : REG_SZ

Description Corresponds to the Err option that specifies the error control flags. Corresponds to the Ctl option that controls the debug output. Corresponds to the Cat option that specifies the debug categories. Corresponds to the Break option that breaks into the debugger. Corresponds to the Indent option that sets the indent for the debug output. Corresponds to the File option that specifies the name of the file to which the debug output is redirected. Determines whether the WinInet debug engine is active.  

"1" - Enables the debug engine. "0" - Disables the debug engine. All of the debug control options are ignored.