sp_trace_setstatus (Transact-SQL)
Si applica a: 
SQL Server
Modifica lo stato corrente della traccia specificata.
Importante
Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. In alternativa, usare Eventi estesi.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
sp_trace_setstatus
[ @traceid = ] traceid
, [ @status = ] status
[ ; ]
Argomenti
[ @traceid = ] traceid
ID della traccia da modificare. @traceid è int, senza impostazione predefinita. L'utente usa questo valore @traceid per identificare, modificare e controllare la traccia. Per informazioni sul recupero del @traceid, vedere sys.fn_trace_getinfo.
[ @status = ] status
Specifica l'azione da implementare nella traccia. @status è int, senza impostazione predefinita.
La tabella seguente elenca lo stato che è possibile specificare.
| Stato | Descrizione |
|---|---|
0 |
Arresta la traccia specificata. |
1 |
Avvia la traccia specificata. |
2 |
Chiude la traccia specificata e ne elimina la definizione dal server. |
Nota
È necessario che la traccia venga arrestata prima di chiuderla. Prima di visualizzare una traccia, è necessario arrestarla e chiuderla.
Valori del codice restituito
Nella tabella seguente vengono descritti i valori di codice che è possibile ottenere, dopo il completamento della stored procedure.
| Codice restituito | Descrizione |
|---|---|
0 |
Nessun errore. |
1 |
Errore sconosciuto. |
8 |
Lo stato specificato non è valido. |
9 |
L'handle di traccia specificato non è valido. |
13 |
Memoria esaurita. Restituito quando non è disponibile memoria sufficiente per eseguire l'azione specificata. |
Se la traccia è già nello stato specificato, SQL Server restituisce 0.
Osservazioni:
I parametri di tutte le stored procedure di traccia SQL (sp_trace_*) sono rigorosamente tipizzato. Se tali parametri non vengono chiamati con i tipi di dati corretti per i parametri di input, come indicato nella descrizione dell'argomento, la stored procedure restituisce un errore.
Per un esempio di utilizzo di stored procedure di traccia, vedere Creare una traccia.
Autorizzazioni
È richiesta l'autorizzazione ALTER TRACE.