Network User Interface Functions (Compact 2013)
3/26/2014
The following table shows the Network User Interface functions.
In This Section
- 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 the 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), 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 (Network UI)
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 |
|
CallNetMsgBox2 |
|
CallGetNetString |
|
CallGetUsernamePassword |
|
CallGetUsernamePasswordEx |
|
CallGetNewPassword |
|
CallGetNewPasswordEx |
|
CallGetResourcePassword |
|
CallGetIPAddress |
|
CallCloseUsernamePasswordDialog |
|
CallConnectionDialog |
|
CallDisconnectDialog |
|
CallAdapterIPProperties |
|
CallLineConfigEdit |
|
CallLineTranslateDialog |