Artículo
09/29/2010

sp_trace_setstatus (Transact-SQL)

Modifica el estado actual de la traza especificada.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @traceid= ] trace_id
Es el Id. de la traza que va a modificarse. trace_id es de tipo int y no tiene ningún valor predeterminado. El usuario utiliza este valor de trace_id para identificar, modificar y controlar la traza. Para obtener información acerca de cómo recuperar el trace_id, vea fn_trace_getinfo (Transact-SQL).
[ @status= ] status
Especifica la acción que ha de implementarse en la traza. status es de tipo int y no tiene ningún valor predeterminado.

En la tabla siguiente se muestra una lista de los estados que podrían especificarse.

Estado

Descripción

0

Detiene la traza especificada.

1

Inicia la traza especificada.

2

Cierra la traza especificada y elimina su definición del servidor.

[!NOTA]

Para poder cerrar una traza, primero debe detenerse. Para poder ver una traza, antes debe detenerse y cerrarse.

Estado	Descripción
0	Detiene la traza especificada.
1	Inicia la traza especificada.
2	Cierra la traza especificada y elimina su definición del servidor.

Valores de código de retorno

En la tabla siguiente se describen los valores del código que los usuarios pueden obtener después de completar el procedimiento almacenado.

Código de retorno	Descripción
0	Ningún error.
1	Error desconocido.
8	El estado especificado no es válido.
9	El asa de traza especificado no es válido.
13	Memoria insuficiente. Se devuelve cuando no hay memoria suficiente para realizar la acción especificada.

Si la traza ya se encuentra en el estado especificado, SQL Server devolverá 0.

Notas

Los parámetros de todos los procedimientos almacenados de Traza de SQL (sp_trace_xx) tienen establecimiento inflexible de tipos. Si no se llama a estos parámetros con los tipos de datos de parámetros de entrada correctos, según se especifica en la descripción del argumento, el procedimiento almacenado devolverá un error.

Para obtener un ejemplo de cómo usar los procedimientos almacenados de seguimiento, vea Cómo crear una traza (Transact-SQL).