CONTEXT_INFO (Transact-SQL)

返回 context_info 值,该值通过使用 SET CONTEXT_INFO 语句为当前会话或批处理设置。

主题链接图标Transact-SQL 语法约定

语法

CONTEXT_INFO()

返回值

context_info 的值;如果未设置 context_info,则值为 NULL。

注释

多个活动的结果集 (MARS) 将使应用程序能够使用相同连接同时运行多个批处理或请求。当 MARS 连接中的一个批处理运行 SET CONTEXT_INFO 时,如果 CONTEXT_INFO 函数作为 SET 语句运行在同一批处理中,则该函数将返回新的上下文值。在该连接上的其他一个或多个批处理中运行的 CONTEXT_INFO 函数不会返回新的值,除非这些批处理在运行 SET 语句的批处理完成之后启动。

权限

不要求具有特殊权限。上下文信息还存储在 sys.dm_exec_requestssys.dm_exec_sessionssys.sysprocesses 系统视图中,但是直接查询这些视图则要求具有 SELECT 和 VIEW SERVER STATE 权限。

示例

以下简单示例将 context_info 值设置为 0x1256698456,然后使用 CONTEXT_INFO 函数检索该值。

SET CONTEXT_INFO 0x1256698456
GO
SELECT CONTEXT_INFO()
GO