sp_trace_setstatus (Transact-SQL)
Modifies the current state of the specified trace.
Transact-SQL Syntax Conventions
- [ @traceid = ] trace_id
-
Is the ID of the trace to be modified. trace_id is int, with no default. The user employs this trace_id value to identify, modify, and control the trace. For information about retrieving the trace_id, see fn_trace_getinfo (Transact-SQL).
- [ @status = ] status
-
Specifies the action to implement on the trace. status is int, with no default.
The following table lists the status that may be specified.
Status Description 0
Stops the specified trace.
1
Starts the specified trace.
2
Closes the specified trace and deletes its definition from the server.
Note: A trace must be stopped first before it can be closed. A trace must be stopped and closed first before it can be viewed.
The following table describes the code values that users may get following completion of the stored procedure.
| Return code | Description |
|---|---|
|
0 |
No error. |
|
1 |
Unknown error. |
|
8 |
The specified Status is not valid. |
|
9 |
The specified Trace Handle is not valid. |
|
13 |
Out of memory. Returned when there is not enough memory to perform the specified action. |
If the trace is already in the state specified, SQL Server will return 0.