Ethman

  • Article

Ethman is a sample application that provides network status and wireless configuration information. It is invoked from the sample shell by using an icon on the taskbar.

The following table shows the Ethman functions that are exported by NetUI. A sample of these functions and their return values are contained in Ethman.h in the %_WINCEROOT%\Public\Common\Oak\Drivers\Netsamp\Ethman directory.

Function Description Parameters
AddNetUISystrayIcon Adds an icon to the system tray for a network adapter.
  • ptcDeviceName is a unique device name.
  • fWireless indicates the adapter type. TRUE indicates a wireless adapter. FALSE indicates a wired adapter.
  • phWnd is a pointer to the handle of the window associated with the system tray icon.
RemoveNetUISystrayIcon Removes an icon from the tray for a network adapter.
  • ptcDeviceName is a unique device name to remove.
IsPropSheetDialogMessage Netui currently maintains a list that associates a property sheet with each of the HWNDs returned in AddNetUISystrayIcon. Because ethman actually has the message pump, it is necessary to provide this function which should call into PropSheet_IsDialogMessage and return this result.
  • hWnd is a window handle.
  • pMsg is a pointer to the window message.
ClosePropSheetDialogIfReady For a modeless property sheet, the message pump must call into PropSheet_GetCurrentPageHwnd to determine if the property sheet should be destroyed. This function must look up the property sheet of the associated hWnd and destroy the window if necessary.
  • hWnd is window handle.
UpdateConnectionStatus Update the status of a given tray icon to either by connected or not connected.
  • ptcDeviceName is a device name.
  • fConnection indicates the new status of the icon. TRUE indicates connected FALSE indicates not connected.

Note   When Ethman adds a wireless adapter, a dialog box that allows the user to set the wireless properties appears. These properties are then set in the wzcuip.c file for use by the operating system.

See Also

How to Replace the Network UI for a Target Device | Functions Exported by the Network UI | Connmc | Rnaapp | Pegterm

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.