DosSendSignal

Bindings:  C, MASM 

This call sends either a SIGINTR or a SIGBREAK signal to a process within 
a specified process tree. 

 DosSendSignal     (PID, SigNumber) 
 

 PID (USHORT) - input 
    Root process ID of the subtree.  It is not necessary that this process 
    be alive, but it is necessary that this process be a direct child 
    process of the process that issues this call. 

 SigNumber (USHORT) - input 
    Signal to send.  It may be: 

    Value     Definition 
    1         (SIGINTR) Ctrl-C 
    4         (SIGBREAK) Ctrl-Break. 

 rc (USHORT) - return 
    Return code descriptions are: 

    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 

 The process that receives the signal is the most distant descendent 
 process among those processes in the tree that have a handler installed 
 for the signal. 

 The process tree is searched in descending order for processes having a 
 handler installed for the specified signal.  If there is at least one 
 eligible process in the tree, the signal is sent to the process that is 
 the most distant descendent process among the eligible processes.  The 
 selected process may have descendents, but none of them have the handler 
 installed for the signal.  If there is more than one most distant 
 descendent eligible process, the signal is sent to one of them; which one 
 is indeterminate. 

 Presentation Manager applications may not establish signal handlers for 
 Ctrl-C and Ctrl-Break.  Establishing a signal handler for Ctrl-C and 
 Ctrl-Break is supported for VIO-Windowable and full-screen applications.