NetMsgBox

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.

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

Parameters

  • hParent
    Handle to the parent window to which the dialog box is to be attached.
  • dwFlags
    The type of message box. The following list shows the possible values. This can be one of these values:
    • NMB_FL_OK
    • NMB_FL_EXCLAIM
    • NMB_FL_YESNO
    • NMB_FL_TOPMOST
    • NMB_FL_TITLEUSB
  • szStr
    Null-terminated string that contains the text to appear in the dialog box.

Return Values

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 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

OS Versions: Windows CE 2.10 and later.
Header: Netui.h.
Link Library: Netui.lib.

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.