sp_trace_setstatus (Transact-SQL)
S'applique à : 
SQL Server
Modifie l'état actuel de la trace spécifiée.
Important
Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt des événements étendus.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_trace_setstatus
[ @traceid = ] traceid
, [ @status = ] status
[ ; ]
Arguments
[ @traceid = ] traceid
ID de la trace à modifier. @traceid est int, sans valeur par défaut. L’utilisateur utilise cette valeur @traceid pour identifier, modifier et contrôler la trace. Pour plus d’informations sur la récupération du @traceid, consultez sys.fn_trace_getinfo.
[ @status = ] état
Indique l'action à implémenter sur la trace. @status est int, sans valeur par défaut.
Le tableau suivant répertorie l’état qui peut être spécifié.
| Statut | 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. |
Remarque
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.
Valeurs des codes de retour
Le tableau suivant décrit les valeurs de code que vous pouvez obtenir, après la fin 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 handle de trace spécifié n’est pas valide. |
13 |
Mémoire insuffisante. Retourné lorsqu’il n’y a pas suffisamment de mémoire pour effectuer l’action spécifiée. |
Si la trace est déjà dans l’état spécifié, SQL Server retourne 0.
Notes
Les paramètres de toutes les procédures stockées trace SQL (sp_trace_*) sont strictement typés. Si ces paramètres ne sont pas appelés à l’aide des types de données appropriés pour les paramètres d’entrée tels qu’ils sont spécifiés dans la description de l’argument, la procédure stockée retourne une erreur.
Pour obtenir un exemple d’utilisation de procédures stockées de trace, consultez Créer une trace.
autorisations
Nécessite l’autorisation ALTER TRACE.