raise
Sendet ein Signal an das ausführende Programm.
Hinweis
Verwenden Sie diese Methode nicht, um eine Microsoft Store-App herunterzufahren, mit Ausnahme von Test- oder Debuggingszenarien. Programmgesteuerte oder UI-Methoden zum Schließen einer Store-App sind gemäß den Microsoft Store-Richtlinien nicht zulässig. Weitere Informationen finden Sie im Lebenszyklus der UWP-App.
Syntax
int raise(
int sig
);
Parameter
sig
Auszulösendes Signal.
Rückgabewert
raise
gibt bei Erfolg 0 zurück. Andernfalls gibt es einen Wert ungleich 0 (null) zurück.
Hinweise
Die raise
Funktion sendet sig
an das Ausführungsprogramm. Wenn ein vorheriger Aufruf signal
eine Signalbehandlungsfunktion installiert sig
hat, raise
wird diese Funktion ausgeführt. Wenn keine Handlerfunktion installiert wurde, wird die dem Signalwert sig
zugeordnete Standardaktion wie folgt ausgeführt.
Signal | Beschreibung | Standardverhalten |
---|---|---|
SIGABRT |
Nicht ordnungsgemäße Beendigung | Beendet das aufrufende Programm mit Exitcode 3 |
SIGFPE |
Gleitkommafehler | Beendet das aufrufende Programm |
SIGILL |
Ungültige Anweisung | Beendet das aufrufende Programm |
SIGINT |
STRG+C-Unterbrechung | Beendet das aufrufende Programm |
SIGSEGV |
Ungültiger Speicherzugriff | Beendet das aufrufende Programm |
SIGTERM |
An das Programm gesendete Beendigungsanforderung | Ignoriert das Signal |
Wenn das Argument kein gültiges Signal wie oben angegeben ist, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Falls keine Behandlung erfolgt, legt die Funktion errno
auf EINVAL
fest und gibt einen Wert ungleich 0 (null) zurück.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
Anforderungen
Routine | Erforderlicher Header |
---|---|
raise |
<signal.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.