DosSendSignalException

Description

Sends a Ctrl+C or a Ctrl+Break signal exception to another process.

Syntax

#define INCL_DOSEXCEPTIONS
#include <os2.h>

PID       pid;        /*  The identification of the process that is to receive the signal exception. */
ULONG     exception;  /*  The number of the signal exception to send. */
APIRET    ulrc;       /*  Return Code. */

ulrc = DosSendSignalException(pid, exception);

Parameters

pid (PID) - input

The identification of the process that is to receive the signal exception.

exception (ULONG) - input

The number of the signal exception to send.

Possible values are shown in the following list:

1       XCPT_SIGNAL_INTR 
4       XCPT_SIGNAL_BREAK 

ulrc (APIRET) - returns

Return Code.

DosSendSignalException returns one of the following values:

0              NO_ERROR 
1              ERROR_INVALID_FUNCTION 
156            ERROR_SIGNAL_REFUSED 
205            ERROR_NO_SIGNAL_SENT 
209            ERROR_INVALID_SIGNAL_NUMBER 
303            ERROR_INVALID_PROCID 

Remarks

Do not make Presentation Manager calls from exception handlers.

DosSendSignalException sends either an XCPT_SIGNAL_INTR (Ctrl+C) or an XCPT_SIGNAL_BREAK (Ctrl+Break) signal exception to another process.

For a detailed list of the system exceptions, select System Exceptions.

Example Code

This example sends a signal exception to another process.

#define INCL_DOSPROCESS     /* Process and thread values */
#define INCL_DOSEXCEPTIONS  /* DOS exception values      */
#define INCL_DOSERRORS      /* DOS error values          */
#include <os2.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main(USHORT argc, CHAR *argv[] ) {

   APIRET      rc          = NO_ERROR; /* Return code                        */
   PID         pidToIntr   = 0;        /* Interrupt this process             */

   if ( argc < 2 ) {
      printf("sendsig error:  Need to pass PID of thread to interrupt.\n");
      return 1;
   } else {
      pidToIntr = (PID) atoi ( argv[1] );
   } /* endif */

   rc = DosSendSignalException ( pidToIntr,            /* Process to interrupt */
                                 XCPT_SIGNAL_INTR );   /* Send this signal     */

   if (rc != NO_ERROR) {
      printf("DosSendSignalException error: return code = %u\n", rc);
      return 1;
   } else {
      printf ("DosSendSignalException complete.\n");
   } /* endif */

   return NO_ERROR;
}

Related Functions

• DosAcknowledgeSignalException
• DosEnterMustComplete
• DosExitMustComplete
• DosRaiseException
• DosSetExceptionHandler
• DosSetSignalExceptionFocus
• DosUnsetExceptionHandler
• DosUnwindException