sp_trace_setstatus (Transact-SQL)
Gilt für: 
SQL Server
Ändert den aktuellen Status der angegebenen Ablaufverfolgung.
Wichtig
Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Verwenden Sie stattdessen erweiterte Ereignisse.
Transact-SQL-Syntaxkonventionen
Syntax
sp_trace_setstatus
[ @traceid = ] traceid
, [ @status = ] status
[ ; ]
Argumente
[ @traceid = ] traceid
Die ID der zu ändernden Ablaufverfolgung. @traceid ist "int" ohne Standard. Der Benutzer verwendet diesen @traceid Wert, um die Ablaufverfolgung zu identifizieren, zu ändern und zu steuern. Informationen zum Abrufen der @traceid finden Sie unter sys.fn_trace_getinfo.
[ @status = ] Status
Gibt die Aktion an, die für die Ablaufverfolgung implementiert werden soll. @status ist "int" ohne Standard.
In der folgenden Tabelle ist der Status aufgeführt, der angegeben werden kann.
| Status | Beschreibung |
|---|---|
0 |
Beendet die angegebene Ablaufverfolgung. |
1 |
Startet die angegebene Ablaufverfolgung. |
2 |
Schließt die angegebene Ablaufverfolgung und löscht ihre Definition vom Server. |
Hinweis
Eine Ablaufverfolgung muss beendet werden, bevor sie geschlossen werden kann. Eine Ablaufverfolgung muss beendet und geschlossen werden, bevor sie angezeigt werden kann.
Rückgabecodewerte
In der folgenden Tabelle werden die Codewerte beschrieben, die Sie nach Abschluss der gespeicherten Prozedur abrufen können.
| Rückgabecode | Beschreibung |
|---|---|
0 |
Kein Fehler. |
1 |
Unbekannter Fehler. |
8 |
Der angegebene Status ist ungültig. |
9 |
Der angegebene Ablaufverfolgungshandle ist ungültig. |
13 |
Nicht genügend Arbeitsspeicher. Wird zurückgegeben, wenn nicht genügend Arbeitsspeicher zum Ausführen der angegebenen Aktion vorhanden ist. |
Wenn sich die Ablaufverfolgung bereits im angegebenen Zustand befindet, gibt SQL Server zurück 0.
Hinweise
Parameter aller gespeicherten SQL Trace-Prozeduren (sp_trace_*) werden streng eingegeben. Wenn diese Parameter nicht mit den richtigen Datentypen für Eingabeparameter aufgerufen werden, wie in der Argumentbeschreibung angegeben, gibt die gespeicherte Prozedur einen Fehler zurück.
Ein Beispiel für die Verwendung gespeicherter Ablaufverfolgungsprozeduren finden Sie unter Erstellen einer Ablaufverfolgung.
Berechtigungen
Erfordert DIE ALTER TRACE-Berechtigung.