返回事务的唯一标识符。 该唯一标识符被引用为绑定令牌。sp_getbindtoken 返回用于在客户端之间共享事务的字符串表示法。
sp_getbindtoken [@out_token =] 'return_value' OUTPUT [, @for_xp_flag]
[@out_token =] 'return_value'
是用于共享事务的令牌。return_value 的数据类型为 varchar(255)，没有默认值。
@for_xp_flag
常量。如果等于 1，则创建一个绑定令牌，该令牌可被传递给扩展存储过程以回调服务器。
无
无
在 Microsoft SQL Server 2000 中，sp_getbindtoken 仅当在活动事务内部执行该存储过程时才返回有效令牌。 否则，SQL Server 将返回一个错误信息。例如：
说明 在 SQL Server 7.0 中，即使在活动事务外部执行该存储过程，sp_getbindtoken 也返回有效令牌。下例工作于 SQL Server 7.0 环境中。
/*open a database*/
USE MYDB
GO
/*declare bind token; no active transaction*/
DECLARE @bind_token varchar(255)
/*return bind token*/
EXECUTE sp_getbindtoken @bind_token OUTPUT
/*get an error message*/
Server: Msg 3921, Level 16, State 1, Procedure sp_getbindtoken, Line 4
Cannot get a transaction token if there is no transaction active.
Reissue the statement after a transaction has been started.
当 sp_getbindtoken 用于在打开的事务内登记分布式事务连接时，SQL Server 2000 返回同一令牌。例如：
USE MYDB
DECLARE @bind_token varchar(255)
BEGIN TRAN
EXECUTE sp_getbindtoken @bind_token OUTPUT
SELECT @bind_token AS Token
BEGIN DISTRIBUTED TRAN
EXECUTE sp_getbindtoken @bind_token OUTPUT
SELECT @bind_token AS Token
/*returns the same token*/
Token
-----
PKb'gN5<9aGEedk_16>8U=5---/5G=--
(1 row(s_) affected)
Token
-----
PKb'gN5<9aGEedk_16>8U=5---/5G=--
(1 row(s_) affected)
绑定令牌可以与 sp_bindsession 一起使用，将新会话绑定到同一事务上。绑定令牌仅在每个 SQL Server 的本地机上有效且不能在多个 SQL Server 实例中共享。
若要获得并传递绑定令牌，则必须在运行 sp_bindsession 之前运行 sp_getbindtoken，以共享同一锁空间。如果获得绑定令牌，则 sp_bindsession 可正确运行。
说明 建议使用 srv_getbindtoken 开放式数据服务 API 来获得从扩展存储过程处使用的绑定令牌。
执行权限默认授予 public 角色。
下面的示例获得绑定令牌并显示绑定令牌名称。
DECLARE @bind_token varchar(255)
BEGIN TRAN
EXECUTE sp_getbindtoken @bind_token OUTPUT
SELECT @bind_token AS Token
下面是结果集：
Token
----------------------------------------------------------
\0]---5^PJK51bP<1F<-7U-]ANZ
下面的示例指定用于向服务器回叫的常量。
DECLARE @bind_token varchar(255)
BEGIN TRAN
EXECUTE sp_getbindtoken @bind_token OUTPUT, 1
SELECT @bind_token AS Token
如果 @for_xp_flag 没有使用常量，将返回下列错误信息：
Msg 214, Level 16, State 1, Server <server_name>, Procedure <procedure_name>, Line 5
Cannot convert parameter @for_xp_flag to type constant expected by procedure.