创建用户定义事件。

语法

sp_trace_generateevent [ @eventid = ] event_id

    [ , [ @userinfo = ] 'user_info' ]

    [ , [ @userdata = ] user_data ]

参数

[ @eventid = ] event_id

是要打开的事件 ID。event_id 的数据类型为 int，没有默认设置。此 ID 必须是事件号 82 至 91 中的一个，它表示用 sp_trace_setevent 设置的用户定义事件。

[ @userinfo = ] 'user_info'

是识别事件原因的可选的用户定义字符串。user_info 的数据类型为 nvarchar(128)，默认设置为 NULL。

[ @userdata = ] user_data

是用于事件的可选的用户指定数据。user_data 的数据类型为 varbinary(8000)，默认设置为 NULL。

返回代码值

下表描述在存储过程完成之后用户可能获得的代码值。

注释

sp_trace_generateevent 是一个 Microsoft SQL Server 2000 存储过程，它执行以前由 SQL Server 早期版本中使用的 xp_trace_* 扩展存储过程执行的许多操作。使用 sp_trace_generateevent 而不使用 xp_trace_generate_event。

只有用户定义事件的 ID 号可用于 sp_trace_generateevent中。如果使用其它事件 ID 号，则 SQL Server 将产生错误。

严格地键入所有 SQL 跟踪存储过程 (sp_trace_xx) 的参数。如果没有用正确的输入参数数据类型（与在参数说明中指定的相同）调用这些参数，则存储过程将返回错误。

权限

只有 sysadmin 固定服务器角色成员才能执行 sp_trace_generateevent。

示例