|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| kernel32.lib
| Header File
| wincon.h
| Unicode
| No
| Platform Notes
| None
|
|
|
GenerateConsoleCtrlEvent
The GenerateConsoleCtrlEvent function sends a specified signal to a console process group that shares the
console associated with the calling process.
BOOL GenerateConsoleCtrlEvent(
DWORD dwCtrlEvent,
| // signal to generate
| DWORD dwProcessGroupId
| // process group to get signal
| );
|
|
Parameters
dwCtrlEvent
Specifies the type of signal to generate. One of the following values is
specified:
Value
| Meaning
| CTRL_C_EVENT
| Generates a CTRL+C signal.
| CTRL_BREAK_EVENT
| Generates a CTRL+BREAK signal.
|
dwProcessGroupId
Specifies the identifier of the process group that receives the signal. A
process group is created when the CREATE_NEW_PROCESS_GROUP flag is specified in a
call to the CreateProcess function. The process identifier of the new process is also the process group
identifier of a new process group. The process group includes all processes
that are descendants of the root process. Only those processes in the group that
share the same console as the calling process receive the signal. In other
words, if a process in the group creates a new console, that process does not
receive the signal, nor do its descendants.
If this parameter is zero, the signal is generated in all processes that share
the console of the calling process.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error
information, call GetLastError.
Remarks
GenerateConsoleCtrlEvent causes the control handler functions of processes in the target group to be
called. All console processes have a default handler function that calls the ExitProcess function. A console process can use the SetConsoleCtrlHandler function to install or remove other handler functions.
SetConsoleCtrlHandler can also enable an inheritable attribute that causes the calling process to
ignore CTRL+C signals. If GenerateConsoleCtrlEvent sends a CTRL+C signal to a process for which this attribute is enabled, the handler
functions for that process are not called. CTRL+BREAK signals always cause the handler functions to be called.
See Also
CreateProcess, ExitProcess, SetConsoleCtrlHandler
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
