DosSuppressPopUps (Suppress Trap Exception Pop-Up Messages)

DosSuppressPopUps allows an application to enable or disable dynamically Trap Exception pop-up suppression and to specify the drive where the pop-up suppression log will be recorded.

The default setting is for disabled pop-up suppression unless overridden by the SUPPRESSPOPUPS CONFIG.SYS command.

Syntax

     APIRET APIENTRY DosSuppressPopUps(ULONG Flag, ULONG Drive);
32-bit code Example using CSet/2

Parameters

Flag

Doubleword field that may take one of the following values:

• SPU_DISABLESUPPRESSION 0x00000000L)
Disable pop-up suppression

• SPU_ENABLESUPPRESSION 0x00000001L)
Enable pop-up suppression and pop-up logging to file POPUPLOG.OS2 on drive specified by the Drive parameter.
Drive
Doubleword containing the ASCII value of the drive letter to which the POPUPLOG.OS2 log file will be written when SPU_ENABLESUPPRESSION is specified. With SPU_DISABLESUPPRESSION, Drive is ignored.

Returns.

Return Code.

DosSuppressPopups returns the following values:

• NO_ERROR

  87

  ERROR_INVALID_PARAMETER

  Remarks.

  The directory to which POPUPLOG.OS2 will be written is always the root directory of Drive.

  A prototype definition of DosSuppressPopUps may be found under RAS API Prototypes.

  See also DosError API in the Control Program Programming Reference.

  ---

  [Back: DosDumpProcess (Enable/Disable ProcessDump)]
  [Next: DosQueryRASInfo (Query RAS Information)]