sp_trace_setstatus (Transact-SQL)
Область применения: 
SQL Server
Изменяет текущее состояние указанной трассировки.
Внимание
Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте расширенные события.
Соглашения о синтаксисе Transact-SQL
Синтаксис
sp_trace_setstatus
[ @traceid = ] traceid
, [ @status = ] status
[ ; ]
Аргументы
[ @traceid = ] traceid
Идентификатор измененной трассировки. @traceid не используется без значения по умолчанию. Пользователь использует это значение @traceid для идентификации, изменения и управления трассировки. Сведения о получении @traceid см. в sys.fn_trace_getinfo.
[ @status = ] состояние
Указывает действие с трассировкой для реализации. @status не используется без значения по умолчанию.
В следующей таблице перечислены сведения о состоянии, которое можно указать.
| Состояние | Description |
|---|---|
0 |
Останавливает указанную трассировку. |
1 |
Начинает указанную трассировку. |
2 |
Закрывает указанную трассировку и удаляет ее определение из сервера. |
Примечание.
Перед закрытием трассировка должна быть остановлена. Перед просмотром трассировка должна быть остановлена и закрыта.
Значения кода возврата
В следующей таблице описаны значения кода, которые можно получить, после завершения хранимой процедуры.
| Код возврата | Description |
|---|---|
0 |
Нет ошибки. |
1 |
Неизвестную погрешность. |
8 |
Указанное состояние недопустимо. |
9 |
Указанный дескриптор трассировки недействителен. |
13 |
Нехватка памяти. Возвращается, когда недостаточно памяти для выполнения указанного действия. |
Если трассировка уже находится в указанном состоянии, SQL Server возвращается 0.
Замечания
Параметры всех хранимых процедур трассировки SQL (sp_trace_*) строго типизированны. Если эти параметры не вызываются с правильными типами данных входных параметров, как указано в описании аргумента, хранимая процедура возвращает ошибку.
Пример использования хранимых процедур трассировки см. в разделе "Создание трассировки".
Разрешения
Требуется разрешение ALTER TRACE.