xp_trace_getqueuedestination (T-SQL)

Retrieves the current trace queue destination value, which is configured by executing xp_trace_setqueuedestination and associated with the specified trace queue.

Syntax

xp_trace_getqueuedestination {queue_handle} [, destination]

Arguments

queue_handle: Is an integer representing 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.
destination: Is an integer indicating the destination for the trace queue data. For the possible values for destination, see xp_trace_setqueuedestination. If destination is not supplied, all four possible destinations and their values are listed.

Return Code Values

0 (success) or >1 (failure)

Result Sets

Column name	Description
Destination	Destination value for trace events
On	Whether the Destination is enabled (1) or not (0)
Server	Name of the server for the Destination
Object	Name of the object (for example, table name if Destination is a table)

Permissions

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

Examples

This example retrieves the destinations, if one or more exist (one or more may have been set by previously executing xp_trace_setqueuedestination) for the specified trace queue (@queue_handle).

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_getqueuedestination @queue_handle

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