Using the Remote Configuration Framework (Windows CE 5.0)
The Remote Configuration Framework provides a set of utility libraries and a mechanism for configuring remote devices. The Remote Configuration Framework uses the concept of configuration module to add functionality to different remote scenarios.
Each module provides a specific functionality. For example, you can use the HOSTNAME module to set and retrieve the host name for a device. Each module communicates with the Web server through an ISAPI extension. This ISAPI extension provides a uniform way for parameters to be passed to and from the server. For a list of the remote configuration modules included in Windows CE, see Remote Configuration Framework Modules.
The following example shows the .htm script for a Web page that allows users to set the host name for a device.
##include HOSTNAME##
<html>
<form METHOD=POST>
Change HostName: <input type=text name=HOSTNAME_Name>
</form>
</html>
The ##include HOSTNAME## syntax instructs the ISAPI extension to append the following JavaScript code to the .htm file.
<script language="javascript">
var g_HOSTNAME_Name = "myhostname";
</script>
**Note **JavaScript enables you to use the g_HOSTNAME_Name variable to display the host name.
To set the host name, the .htm file includes a form that submits HOSTNAME_NAME to the ISAPI extension. The ISAPI extension then forwards the variable to the HOSTNAME module for processing.
The following example shows the .htm script for the Web page users will see after entering the host name for a device.
##include HOSTNAME##
<html>
The device Hostname is: <script>document.write(g_HOSTNAME_Name);</script>
</html>
Marshaling
The Remote Configuration Framework uses the following value conversion to marshal parameters in and out of the ISAPI extension:
HTML to ISAPI extension
MODULE_Variable = Value, for non-array values
a_MODULE_Variable_Index = Value, for values in an array
ISAPI extension to HTML
g_MODULE_Variable = Value, for non array values
g_MODULE_Variable[Index] = Value, for values in an array
See Also
Remote Configuration Framework Modules
Send Feedback on this topic to the authors