Microsoft Windows CE 3.0  

Virtual Path Settings

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Virtual paths specify a mapping between the virtual path in a URL and the physical path on the device. For example, you can allow a client browser to connect to http://www.computername.com/www/sample.htm while retrieving the file that is named Sample.htm from the \Windows\www\data directory. To accomplish this, specify a mapping between the /www virtual path and the \Windows\www\data physical path.

At least one virtual path must be created before the Web server starts. If no valid virtual path mappings have been specified, the Web server cannot perform any mappings, and returns the "404 - Object not found" status code for all requests.

If a Web client browser requests a directory, the Web server searches for default pages in the corresponding physical directory, following the order in which they are listed in the registry. If no pages are found and the DirBrowseregistry value is nonzero, the Web server sends a list of links to all of the files and directories in the requested directory. If no default pages are found and the DirBrowseregistry value is zero, the Web server sends the "403 - Forbidden" status code.

HKEY_LOCAL_MACHINE\Comm\HTTPD\VROOTSis the virtual path protected registry key. This registry key contains one or more subkeys, one for each virtual path. Each subkey is named for the virtual path that it specifies. In the previous example, the registry should contain a registry key that is named HKEY_LOCAL_MACHINE\Comm\HTTPD\VROOTS\www.

Each subkey contains values that specify the physical path, as well as the permission levels, authorization level, and user list that are required for that virtual path. The following table shows the values for each virtual path registry key.

Value Description
(Default) Specifies the physical directory that is mapped to the virtual directory.
A Authentication level that a user must have to access this directory. If no value is set, 0 is used as the default value. For more information, see HTTP Authentication and Permissions.
P Access permissions that are associated with the directory. If no value is set, the default value that is used is either HSE_FLAGS_URL_READ, HSE_FLAGS_URL_EXECUTE, or HSE_FLAGS_URL_SCRIPT. For more information, see HTTP Authentication and Permissions.
UserList Allows authenticated users, groups, or both to be set on a per-virtual-root basis.

The following example shows a subkey that: