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
For a full list of error codes, see Errors.
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;
}