GenerateConsoleCtrlEvent

[funkcja] Wysyła określony sygnał do grupy procesów konsoli zawierających konsolę powiązaną z aktualnym procesem.

Składnia

#include <windows.h>

BOOL WINAPI GenerateConsoleCtrlEvent( DWORD dwCtrlEvent, DWORD dwProcessGroupId );

Argumenty

Argument Opis

dwCtrlEvent

Typ sygnału do utworzenia. Wartość tego argumentu może być jedną z poniższych stałych:

Nazwa	Wartość	Znaczenie
CTRL_C_EVENT	0	Wysyła sygnał `CTRL+C`. Ten sygnał nie może być utworzony dla grupy procesów. Jeśli wartość argumentu `dwProcessGroupId` jest niezerowa, to funkcja zakończy się prawidłowo, ale sygnał `CTRL+C` nie zostanie pobrany przez procesy w określonej grupie procesów.
CTRL_BREAK_EVENT	1	Wysyła sygnał `CTRL+BREAK`.

dwProcessGroupId Identyfikator grupy procesów pobierających sygnał. Grupa procesów jest utworzona, gdy flaga CREATE_NEW_PROCESS_GROUP jest ustawiona przez wywołanie funkcji _{» WinAPI ♦}CreateProcess. Identyfikator nowego procesu jest również identyfikatorem nowej grupy procesów. Grupa procesów włącza wszystkie procesy potomne procesu root. Tylko te procesy w grupie, które mają tą samą konsolę, co wywoływany proces, mogą odebrać sygnał. Jeśli proces w grupie tworzy nową konsolę, ten proces oraz procesy potomne nie pobierają sygnału. Jeśli wartość tego argumentu wynosi 0, sygnał jest tworzony we wszystkich procesach zawierających konsolę powiązaną z wywoływanym procesem.

Zwracana wartość

Jeśli nie wystąpią błędy, zwracana wartość jest niezerowa, inaczej 0. Aby uzyskać szczegółowe informacje o błędzie, wywołaj funkcję _{» WinAPI ♦}GetLastError.

Dodatkowe informacje

Funkcja powoduje wyłuskanie wskaźnika do funkcji dla procesów w danej grupie. Wszystkie procesy konsoli mają domyślny wskaźnik do funkcji wywołujący funkcję ExitProcess. Proces konsoli może używać funkcji _{» WinAPI ♦}SetConsoleCtrlHandler do instalowania lub usuwania innych wskaźników do funkcji. Funkcja może również włączać niedziedziczony atrybut powodujący ignorowanie sygnałów CTRL+C przez wywoływany proces. Sygnały CTRL+BREAK zawsze powodują wywołanie wskaźnika do funkcji.

Wymagania

Minimalny system klienta	Windows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serwera	Windows 2000 Server (tylko aplikacje biurowe).
Nagłówek	Wincon.h (dołącza Windows.h)
Biblioteka	Kernel32.lib
DLL	Kernel32.dll

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/windows/desktop/ms683155(v=vs.85).aspx

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.