sp_trace_setstatus (Transact-SQL)

修改指定追蹤的目前狀態。

重要事項
未來的 Microsoft SQL Server 版本將移除這項功能。請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。請改用擴充事件。

語法

sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status

[ @traceid= ] trace_id
這是要修改的追蹤識別碼。 trace_id 是 int，沒有預設值。使用者會利用這個 trace_id 值來識別、修改和控制追蹤。如需有關擷取 trace_id 的資訊，請參閱＜sys.fn_trace_getinfo (Transact-SQL)＞。
[ @status= ] status
指定追蹤所實作的動作。 status 是 int，沒有預設值。

下表列出可能指定的狀態。

狀態

說明

0

停止指定的追蹤。

1

啟動指定的追蹤。

2

關閉指定的追蹤，並從伺服器中刪除其定義。

[!附註]

您必須先關閉追蹤，才能將它刪除。您必須先停止和關閉追蹤，才能檢視它。

下表描述在預存程序完成之後，使用者可能得到的代碼值。

傳回碼	說明
0	沒有錯誤。
1	未知的錯誤。
8	指定的狀態無效。
9	指定的追蹤控制代碼無效。
13	記憶體用完。當沒有足夠的記憶體可以執行指定的動作時，便傳回這個代碼。