Article
03/31/2012

sp_trace_setstatus (Transact-SQL)

Modifie l'état actuel de la trace spécifiée.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

[ @traceid= ] trace_id
ID de la trace à modifier. L'argument trace_id est de type int et ne possède pas de valeur par défaut. L'utilisateur emploie cette valeur trace_id pour identifier, modifier et contrôler la trace. Pour plus d'informations sur la récupération de l'argument trace_id, consultez fn_trace_getinfo (Transact-SQL).
[ @status= ] status
Indique l'action à implémenter sur la trace. L'argument status est de type int et n'a pas de valeur par défaut.

Le tableau ci-après répertorie les états qui peuvent être spécifiés.

État

Description

0

Arrête la trace spécifiée.

1

Démarre la trace spécifiée.

2

Ferme la trace spécifiée et supprime sa définition du serveur.

Notes

Une trace doit d'abord être arrêtée avant d'être fermée de la même façon qu'elle doit d'abord être arrêtée et fermée avant de pouvoir être consultée.

État	Description
0	Arrête la trace spécifiée.
1	Démarre la trace spécifiée.
2	Ferme la trace spécifiée et supprime sa définition du serveur.

Valeurs des codes de retour

Le tableau suivant décrit les valeurs de code que les utilisateurs peuvent recevoir à la fin de l'exécution de la procédure stockée.

Code de retour	Description
0	Aucune erreur.
1	Erreur inconnue.
8	L'état spécifié n'est pas valide.
9	Le descripteur de trace spécifié n'est pas valide.
13	Mémoire insuffisante. Ce code est retourné lorsqu'il n'y a pas assez de mémoire pour exécuter l'action spécifiée.

Si la trace présente déjà l'état spécifié, SQL Server retourne 0.

Notes

Les paramètres de toutes les procédures stockées SQL Trace (sp_trace_xx) possèdent un type précis. Si ces paramètres ne sont pas appelés à l'aide des types de données des paramètres d'entrée appropriés, comme spécifié dans la description de l'argument, la procédure stockée renvoie une erreur.

Pour obtenir un exemple d'utilisation de procédures stockées de trace, consultez Procédure : créer une trace (Transact-SQL).