Articolo
09/28/2010

sp_trace_setstatus (Transact-SQL)

Modifica lo stato corrente della traccia specificata.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

[ @traceid= ] trace_id
ID della traccia da modificare. trace_id è di tipo int e non prevede alcun valore predefinito. Tramite il valore trace_id l'utente può identificare, modificare e controllare la traccia. Per informazioni sul recupero del valore trace_id, vedere fn_trace_getinfo (Transact-SQL).
[ @status= ] status
Specifica l'azione da implementare nella traccia. status è di tipo int e non prevede alcun valore predefinito.

Nella tabella seguente sono inclusi i possibili valori di stato.

Stato

Descrizione

0

Interrompe la traccia specificata.

1

Avvia la traccia specificata.

2

Chiude la traccia specificata e ne elimina la definizione dal server.

[!NOTA]

Prima di chiudere una traccia, è necessario interromperla. Prima di visualizzare una traccia, è necessario interromperla e chiuderla.

Stato	Descrizione
0	Interrompe la traccia specificata.
1	Avvia la traccia specificata.
2	Chiude la traccia specificata e ne elimina la definizione dal server.

Valori restituiti

Nella tabella seguente vengono descritti i possibili valori di codice visualizzati al 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 la quantità di memoria disponibile non è sufficiente per eseguire l'azione specificata.

Se lo stato corrente della traccia corrisponde a quello specificato, SQL Server restituisce 0.

Osservazioni

I parametri di tutte le stored procedure SQL Trace (sp_trace_xx) devono essere fortemente tipizzati. Se questi parametri non vengono chiamati con i tipi di dati corretti per i parametri di input, come indicato nella descrizione dell'argomento, la stored procedure restituirà un errore.

Per un esempio dell'utilizzo di stored procedure relative alla traccia, vedere Procedura: Creazione di una traccia (Transact-SQL).