可选元数据

作为开发人员，可以选择让事务集成器 (TI) 运行时环境向大型机事务程序发送和接收元数据 (TP) ，还可以选择该元数据的内容。

注意

分布式程序调用 (DPC) 不支持元数据。

可以发送或接收：

• 无元数据。

• 仅将方法名称作为元数据。

• 包括方法名称在内的所有元数据。

  TI 运行时环境按照指示向/从 TP 发送或接收元数据。 元数据在以下方面帮助 TP：

• 标识元数据的格式 (版本信息) 。

• 标识用于调用 TP 的方法的名称。

• 向客户端报告详细的错误信息。

  元数据对自动化客户端不可见。 元数据将传递到 (或从主机 TP) 接收，作为发送到 (的请求消息的一部分，或从 TP) 收到的响应消息的一部分。

  元数据集包括以下数据：

• TI 运行时版本。

  一个字符串，例如“Microsoft TI 版本 1.0.0”，用于唯一标识生成请求的 TI 运行时环境版本。

• 方法名称 (客户端应用程序代码调用的 32 个字符的字符串) 。

• 元数据块 ID。

  唯一标识此异常数据块的 GUID（字符格式）。 GUID 支持将来具有其他异常格式的功能，并帮助确保接收的任何数据都有效。

• 至今未分配使用 (保留) 的变量：

  • 指示 TP 是否已准备好提交的布尔标志。

  • 指示 TP 是否已准备好执行其他工作的布尔标志。

  • 两个短整数用于保存 TI 运行时环境版本号的片段，一个短整数用于保存主版本号，另一个用于保存次要版本号。

• 异常块 (仅用于答复) 。

  唯一标识此异常数据块的二进制格式 GUID。 GUID 允许将来支持其他异常格式，并帮助确保收到的数据有效：

  • 指示 TP 是否已准备好提交的布尔标志。

  • 指示 TP 是否已准备好执行其他工作的布尔标志。

  • 指示是否应将异常返回给客户端应用程序的布尔标志。 如果设置，此标志还会导致事务退出。

  • 标识错误的 16 位整数 (请参阅本主题后面的注释) 。 可以从服务器分配此值以及描述错误的 256 个字符的消息，以便在发生 TI 运行时错误时返回分配的值。

  • 标识 TP 帮助文件中上下文 ID 的 32 位整数 (（如果有任何) ）。

  • 描述错误的 256 个字符的消息。 可以分配此值以及标识服务器错误的 16 位整数，以便在发生 TI 运行时错误时返回分配的值。

  元数据始终位于消息的开头。

注意

TI 错误消息的数字范围为 0 到 9999。 从大型机返回的元数据错误消息编号可能位于同一范围内。 为了将 TI 错误消息与从大型机返回的元数据消息区分开来，TI 会将 10000 添加到从大型机返回的任何元数据错误消息的数量。