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 sighat, 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.

Siehe auch

Prozess- und Umgebungskontrolle
abort
signal