Network User Interface Functions (Windows CE 5.0)
The following table shows the Network User Interface functions.
| Programming element | Description |
|---|---|
| AdapterIPProperties | Implements the IP Properties dialog box displayed in the network connections UI that allows users to configure Internet Protocol (IP) addressing, Domain Name System (DNS)/Windows Internet Name Service (WINS) information, and wireless local area network (LAN) settings. |
| CheckAndWaitForGWE | Checks whether window manager is present, and if so, waits until it has initialized. |
| CloseUsernamePasswordDialog | Closes a username and password dialog box. |
| ConnectionDialog | Displays a dialog box that allows a user to connect to a network resource. This function is called by the network redirector when an application calls WNetConnectionDialog1. |
| CreateScanDevice | Displays a dialog box that allows the user to manipulate, find, query, add, and delete Bluetooth-enabled devices. |
| DisconnectDialog | Displays a dialog box that allows a user to disconnect from a network resource. This function is called by the network redirector when the application calls WNetDisconnectDialog. |
| GetDriverName | Prompts the user to enter a driver for an unrecognized device. Installable bus drivers in the operating system (OS) such as universal serial bus (USB) and PC Cards call this function. |
| GetIPAddress | Prompts the user for the IP address if the Serial Line Internet Protocol (SLIP) connection does not have a valid IP address. Point-to-Point Protocol (PPP) calls this function. |
| GetNetString | Loads a string used by the network user interface. Retrieves a string resource from Netui.res, typically in preparation for calling another NetUI function, such as NetMsgBox. |
| GetNewPassword | Displays the dialog box that prompts the user for a new password when their password has expired. Point-to-Point Protocol (PPP) calls this function. |
| GetNewPasswordEx | Similar to GetNewPassword, but also returns a handle to a window that can be used to dismiss the dialog box programmatically through CloseUsernamePasswordDialog. |
| GetResourcePassword | Prompts the user to enter a password for a password-protected network share. The redirector calls this function. |
| GetUsernamePassword | Retrieves user credentials for OS components such as PPP and the redirector. Interacts with the OS credential manager to persist user credentials as appropriate. |
| GetUsernamePasswordEx | Similar to GetUsernamePassword. Also returns a handle to a window that can be used to dismiss the dialog box programmatically through CloseUsernamePasswordDialog. |
| LineConfigEdit | Displays a dialog box that allows a user to edit the configurations of a specified modem line. This function is called when Telephony API (TAPI) calls lineConfigDialogEdit on a Unimodem device. |
| LineTranslateDialog | Displays a dialog box that allows a user to change the current location of a phone number about to be dialed, adjust location and calling card parameters, and see the effect on a phone number about to be dialed. This function is called when Telephony API (TAPI) calls lineTranslateDialog on a Unimodem device. |
| NetMsgBox | Displays a network message dialog box to notify a user of network errors and events. |
| RegisterIPClass | Registers the IP address window class that is displayed in the network connections UI. |
| UnregisterIPClass | Unregisters the IP address window class that is displayed in the network connections UI. |
You can use wrappers with OS designs that may or may not have netui.dll present. The following table shows the wrappers that you can use.
| Wrapper | Maps to function |
|---|---|
| CallNetMsgBox | NetMsgBox |
| CallNetMsgBox2 | NetMsgBox |
| CallGetNetString | GetNetString |
| CallGetUsernamePassword | GetUsernamePassword |
| CallGetUsernamePasswordEx | GetUsernamePasswordEx |
| CallGetNewPassword | GetNewPassword |
| CallGetNewPasswordEx | GetNewPasswordEx |
| CallGetResourcePassword | GetResourcePassword |
| CallGetIPAddress | GetIPAddress |
| CallCloseUsernamePasswordDialog | CloseUsernamePasswordDialog |
| CallConnectionDialog | ConnectionDialog |
| CallDisconnectDialog | DisconnectDialog |
| CallAdapterIPProperties | AdapterIPProperties |
| CallLineConfigEdit | LineConfigEdit |
| CallLineTranslateDialog | LineTranslateDialog (Network UI) |
See Also
Send Feedback on this topic to the authors