NetMsgBox (Windows Embedded CE 6.0)

1/6/2010

This function displays a network message dialog box to notify a user of network errors and events. This function is called by various networking and driver modules to provide error or status messages to the user. It can also be used to indicate that certain events have occurred.

Syntax

BOOL NetMsgBox(
  HWND hParent, 
  DWORD dwFlags, 
  TCHAR* szStr
);

Parameters

• hParent
  [in] Handle to the parent window to which the dialog box is to be attached.

• dwFlags
  [in] The type of message box. The following list shows the possible values:

  • NMB_FL_OK
  • NMB_FL_EXCLAIM
  • NMB_FL_YESNO
  • NMB_FL_TOPMOST
  • NMB_FL_TITLEUSB

• szStr
  [in] Null-terminated string that contains the text to appear in the dialog box.

Return Value

TRUE indicates success. FALSE indicates either a failure or that the user has chosen Cancel on the dialog box.

Remarks

The default title for the network message box is Windows Embedded CE Networking, but it can be modified depending on the value of the parameter dwFlags.

See the definitions of NETUI_GETNETSTR_XXX in the Netui.h file for a list of possible message values. The strings are specified in the Netui.rc file. Both Netui.h and Netui.rc are public code and can be modified to change the appearance of the displayed string.

Requirements

See Also

Other Resources

Network User Interface Functions