Panel użytkownika
Nazwa użytkownika:
Hasło:
Nie masz jeszcze konta?
Hasło nie zostało zweryfikowane
Niniejsze hasło zostało opracowane, jednak nie zostało ono zweryfikowane przez administrację serwisu. Jeżeli znalazłeś błędy merytoryczne w niniejszym dokumencie, prosimy o ich zgłoszenie na forum w dziale Znalezione błędy.
Opracował: jankowalski25
Biblioteki C/C++

GenerateConsoleCtrlEvent

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

Składnia

C/C++
#include <windows.h>

BOOL WINAPI GenerateConsoleCtrlEvent( DWORD dwCtrlEvent, DWORD dwProcessGroupId );

Argumenty

ArgumentOpis
dwCtrlEventTyp sygnału do utworzenia. Wartość tego argumentu może być jedną z poniższych stałych:
NazwaWartośćZnaczenie
CTRL_C_EVENT0Wysył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_EVENT1Wysyła sygnał CTRL+BREAK.
dwProcessGroupIdIdentyfikator grupy procesów pobierających sygnał. Grupa procesów jest utworzona, gdy flaga CREATE_NEW_PROCESS_GROUP jest ustawiona przez wywołanie funkcji » WinAPICreateProcess. 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ę » WinAPIGetLastError.

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 » WinAPISetConsoleCtrlHandler 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 klientaWindows 2000 Professional (tylko aplikacje biurowe).
Minimalny system serweraWindows 2000 Server (tylko aplikacje biurowe).
NagłówekWincon.h (dołącza Windows.h)
BibliotekaKernel32.lib
DLLKernel32.dll

Linki zewnętrzne