How to Replace the Network UI for a Target Device

  • Article

The Network User Interface (UI) feature for Microsoft® Windows® CE .NET defines the user interface components that are used by networking and device driver modules in the Windows CE operating system (OS). This includes the Network and Dial-up Connections application. The Network UI feature provides a set of dialog boxes that can be used by other applications. Network UI functions are contained in Netui.dll, and are accessed by operating system components through wrappers in the %_WINCEROOT%\Public\Common\Oak\Inc\Netui.h file. Therefore, to match the desired users' experience, you can omit implementation of any of these functions from Netui.dll, change the sample implementations to suit the user interface requirements for specific device, or omit the Netui.dll entirely.

Note   The wrappers in Netui.h attempt to find the appropriate function in Netui.dll. If no appropriate function is found, or if netui.dll is not present, Netui.h will return an error code and output a message to the debug console that it could not find the requested function.

Hardware and Software Assumptions

  • Your Platform Builder installation includes the CEPC x86 board support package (BSP).

  • You have a CEPC already configured. For more information, see How to Set Up a CEPC and How to Use the IDE to Create, Customize, and Build a Platform.

  • You have created a platform that includes the Network User Interface. For information about creating a platform, see Creating a Platform. For information about adding a feature to the platform, see Adding a Feature from the Catalog.

    If you do not have a specific platform created, and instead want to use these steps as a tutorial, choose Enterprise WebPad when you create your platform by using the New Platform Wizard.

  • You know the changes that you want to make in the Network UI. The source code for the implemented dialog boxes is in the %_WINCEROOT%\Public\Common\Oak\Drivers\Netui directory.

    For information about the functions that are included in the netui module, see netui Module.

To track your progress in the following table, select the check box next to each step.

  Step Topic
1. Customize the network UI as desired. Customizing the Network UI
2. Prepare to build the Platform.
  • Choose the debug build.
 Selecting a Debug or Release OS Image
3. If your final OS image size is estimated to be larger than 32 MB, such as if you are creating the Enterprise WebPad example, you must perform the following steps:

  • From the Platform menu, choose Settings.

    The Platform Settings dialog box appears.

  • Choose the Build Options tab.
  • Select the Enable Images Larger than 32 MB check box.
  • Choose OK to close the dialog box.
  
4. Prepare to build the private and public tree by performing the following steps:

  • From the Tools menu, choose Options.

    The Options dialog box appears.

  • Choose the Build tab and then select the Enable Deptree Build check box.

    Note   This change is global for Platform Builder. It applies to the current platform, persists, and is applied to other platforms that you load in the future. If you do not want to enable deptree builds when you are working on other platforms, you must clear this check box at that time.
  • To close the dialog box, choose OK.
 Not applicable
5. Build the platform. Building a Platform
6. Configure the connection to the CEPC.
  • In the Active Named Connection dialog box, choose your platform name.
 Configuring a Connection for Downloading and Debugging
7. Download the Image to the CEPC. Downloading an OS Image to a Target Device
8. Test the Network UI change. Testing the Network UI change

See Also

Network User Interface Overview | Communications and Security How-to Topics | Functions Exported by the Network UI

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.