DosSendSignal

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:
• 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.

  ---

  [Back: DosSemWait]
  [Next: DosSetCp]