Telnet Server Registry Settings (Windows Embedded CE 6.0)
1/6/2010
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 protected registry contains named values for configuration.
Note
The default registry values vary depending on which Catalog items are included in your OS design. For more information, see Default Registry Settings.
The Telnet server settings are located under the HKEY_LOCAL_MACHINE\Comm\TELNETD registry key.
Note
HKEY_LOCAL_MACHINE\COMM\TELNETD is a protected (access-restricted) registry key on some devices that run Windows CE 3.0 or later.
The following table shows the named values for the HKEY_LOCAL_MACHINE\Comm\TELNETD key.
| Value | Description |
|---|---|
IsEnabled : REG_DWORD |
Indicates if the Telnet server is enabled. Set this value to a non-zero value to enable the server, and to 0 to disable the server. If the sample Telnet server is started and this value has not been set, it defaults to accepting connections. |
UseAuthentication : REG_DWORD |
To require a password check on the user, set this value to 1; otherwise, set it to 0. By default, the Telnet sample requires authentication. |
UserList : String |
Provides a semicolon-separated list of allowed users. Requires UseAuthentication to be enabled. .gif "Ee499490.security(en-US,WinEmbedded.60).gif") Security Note:
Microsoft recommends that you set this value. Setting this value requires that potential clients supply both a valid username and a password to access the Telnet service.
|
The Telnet sample reads the UseAuthentication and UserList values in the registry before servicing each request. Therefore, changes made to these registry values take effect immediately and do not require the Telnet sample to be restarted.
Telnet also verifies that IsEnabled has a non-zero value before servicing each request. However, if IsEnabled is set to 0 during the Telnet server's initialization, it will never service any requests, even if the registry key is set to a non-zero value after server startup. To start the Telnet server in this case, set IsEnabled to a non-zero value and restart the server.