sp_trace_setstatus (Transact-SQL)
修改指定追蹤的目前狀態。
.gif "主題連結圖示")
語法
sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status
引數
- [ @traceid= ] trace_id
這是要修改的追蹤識別碼。trace_id 是 int，沒有預設值。使用者會利用這個 trace_id 值來識別、修改和控制追蹤。如需有關擷取 trace_id 的資訊，請參閱＜fn_trace_getinfo (Transact-SQL)＞。
[ @status= ] status
指定追蹤所實作的動作。status 是 int，沒有預設值。下表列出可能指定的狀態。
狀態 描述 0
停止指定的追蹤。
1
啟動指定的追蹤。
2
關閉指定的追蹤，並從伺服器中刪除其定義。
.gif "ms176034.note(zh-tw,SQL.90).gif")
附註：您必須先關閉追蹤，才能將它刪除。您必須先停止和關閉追蹤，才能檢視它。
傳回碼值
下表描述在預存程序完成之後，使用者可能得到的代碼值。
| 傳回碼 | 描述 |
|---|---|
0 |
沒有錯誤。 |
1 |
未知的錯誤。 |
8 |
指定的狀態無效。 |
9 |
指定的追蹤控制代碼無效。 |
13 |
記憶體用完。當沒有足夠的記憶體可以執行指定的動作時，便傳回這個代碼。 |
如果追蹤已在指定的狀態中，SQL Server 會傳回 0。
備註
所有 SQL 追蹤預存程序 (sp_trace_xx) 的參數都具備嚴格的類型。如果沒有依照引數描述所指定，以正確的輸入參數資料類型來呼叫這些參數，預存程序會傳回錯誤。
權限
使用者必須有 ALTER TRACE 權限。
請參閱
參考
fn_trace_geteventinfo (Transact-SQL)
fn_trace_getfilterinfo (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)