Share via

Using the Remote Configuration Framework (Windows Embedded CE 6.0)

  • Article

1/6/2010

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 Embedded 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

Concepts

Remote Configuration Framework Application Development
Remote Configuration Framework Modules