Description:

SplMessageBox creates and displays a message box.

The message queue will be created (and destroyed) if necessary. In OS/2 2.1, this API may return Retry automatically if the PM message box is displayed for more than three minutes.

#include <os2.h>

PSZ      pszAddress;   /*  Pointer to a string containing the logical address of the device, such as LPT1. */
ULONG    flErrorInfo;  /*  Error information. */
ULONG    flErrorData;  /*  Length of the data in bytes. */
PSZ      pszText;      /*  Pointer to the text string for the message box. */
PSZ      pszCaption;   /*  Pointer to a string containing a meaningful title for the message box. */
ULONG    idWindow;     /*  Window ID of the message box window. */
ULONG    fsStyle;      /*  Bit array specifying the contents and function of the message box. */
ULONG    Response;     /*  Return codes. */

Response = SplMessageBox(pszAddress, flErrorInfo,
             flErrorData, pszText, pszCaption,
             idWindow, fsStyle);