DosSendSignalException
Sends a Ctrl+C or a Ctrl+Break signal exception to another process.
Syntax
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
Returns
- 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;
}