xp_trace_getuserfilter (T-SQL)

Retrieves the current SQL user filter, which is configured by executing xp_trace_setuserfilter and associated with the specified trace queue.

xp_trace_getuserfilter {queue_handle}

queue_handle: Is an integer that represents the handle for the trace queue. queue_handle is used to reference the trace queue and is placed in an output parameter by xp_trace_addnewqueue.

0 (success) or >1 (failure)

Column name	Description
EventQueue	The trace queue number
IncludeUserFilter	The include user filter value for the trace queue
ExcludeUserFilter	The exclude user filter value for the trace queue

The output shows the include and exclude filters used for the Microsoft® SQL Server™ usernames.

Execute permissions for xp_trace_getuserfilter default to members of the sysadmin fixed server role but can be granted to other users.

This example retrieves the user filter value information for the trace queue.

USE master

DECLARE @queue_handle int, @column_value int

SET @column_value = 16|32|8192|128|512

EXEC xp_trace_addnewqueue 1000,

5,

95,

90,

@column_value,

@queue_handle OUTPUT

EXEC xp_trace_getuserfilter @queue_handle

Monitoring with SQL Server Profiler	System Stored Procedures (SQL Server Profiler Extended Procedures)
xp_trace_setuserfilter