sp_trace_setstatus (Transact-SQL)

Modifica lo stato corrente della traccia specificata.

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.

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.

Autorizzazioni

L'utente deve disporre dell'autorizzazione ALTER TRACE.

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.

Vedere anche

Riferimento

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)

Altre risorse

Introduzione a Traccia SQL

Guida in linea e informazioni

Assistenza su SQL Server 2005