dos12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
DosSendSignal (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSSIGNALS
 
USHORT DosSendSignal(idProcess, usSigNumber)
USHORT idProcess;      /* process identifier of subtree root */
USHORT usSigNumber;    /* signal to send                     */
 
The DosSendSignal function sends a CTRL+C or CTRL+BREAK signal to the last
descendant process that has a corresponding signal handler installed.
 
Parameter    Description
────────────────────────────────────────────────────────────────────────────
 
idProcess    Specifies the process identification code (PID) of the root
             process of the subtree. It is not necessary that this process
             still be running, but it is necessary that this process be a
             direct child of the process that issues this call.
 
usSigNumber  Specifies the signal to send. It can be SIG_CTRLC to send a
             CTRL+C signal, or SIG_CTRLBREAK to send a CTRL+BREAK signal.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, , which may be one of the following:
 
     ERROR_INVALID_FUNCTION
     ERROR_NO_SIGNAL_SENT
     ERROR_NOT_DESCENDANT
     ERROR_SIGNAL_REFUSED
 
See Also
 
DosFlagProcess, DosHoldSignal, DosSetSigHandler