Artigo
04/01/2012

sp_trace_setstatus (Transact-SQL)

Modifica a situação atual do rastreamento especificado.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @traceid= ] trace_id
É a ID do rastreamento a ser modificado. trace_id é int, sem nenhum padrão. O usuário emprega este valor trace_id para identificar, modificar e controlar o rastreamento. Para obter mais informações sobre a recuperação de trace_id, consulte fn_trace_getinfo (Transact-SQL).
[ @status= ] status
Especifica a ação a ser implementada no rastreamento. status é int, sem padrão.

A tabela a seguir descreve o status que pode ser especificado.

Status

Descrição

0

Interrompe o rastreamento especificado.

1

Inicia o rastreamento especificado.

2

Fecha o rastreamento especificado e exclui sua definição do servidor.

Observação

Um rastreamento deve ser interrompido primeiro antes de ser encerrado. Um rastreamento deve ser interrompido e encerrado primeiro antes de ser exibido.

Status	Descrição
0	Interrompe o rastreamento especificado.
1	Inicia o rastreamento especificado.
2	Fecha o rastreamento especificado e exclui sua definição do servidor.

Observação
Um rastreamento deve ser interrompido primeiro antes de ser encerrado. Um rastreamento deve ser interrompido e encerrado primeiro antes de ser exibido.

Valores de código de retorno

A tabela a seguir descreve os valores de código que os usuários podem obter após a conclusão do procedimento armazenado.

Código de retorno	Descrição
0	Nenhum erro.
1	Erro desconhecido.
8	O status especificado não é válido.
9	O Identificador de Rastreamento especificado não é válido.
13	Memória insuficiente. Retornado quando não há memória suficiente para executar a ação especificada.

Se o rastreamento já estiver na situação especificada, SQL Server retornará 0.

Comentários

Os parâmetros de todos os procedimentos armazenados do Rastreamento SQL (sp_trace_xx) são rigorosamente digitados. Se esses parâmetros não forem chamados com os tipos de dados com parâmetro de entrada corretos, como especificado na descrição do argumento, o procedimento armazenado retornará um erro.

Para obter um exemplo do uso de procedimentos armazenados de rastreamento, consulte Como criar um rastreamento (Transact-SQL).