了解扩展错误信息

  • 项目

扩展错误信息是记录数组，每个记录指示通过系统或应用程序中的特定层传递错误代码。 如果计算机 C 上发生错误，因为从计算机 B 调用，而计算机 B 又从计算机 A 调用，则计算机 C 上的 RPC 运行时将生成一条或多条描述错误的记录，并将其传递给计算机 B。计算机 B 可以将一条或多条记录添加到现有链的头， 并将完整链传递给 A。可以添加一条或多条记录，并显示或记录信息。 实际上，扩展的错误链表示错误的历史记录。

扩展错误信息不会替换 (RPC_S_* 状态代码) 的错误代码。 无论生成多少错误信息或是否生成扩展错误信息，错误代码都保持不变。

每个扩展的错误信息记录都包含以下内容。 有关详细信息 ，请参阅RPC_EXTENDED_ERROR_INFO ：

  • ComputerName - 这是发生错误的计算机的非限定 DNS 名称。 只有计算机边界上的记录才包含此信息。 例如，在前面所述的计算机 A、B 和 C 方案中，ComputerName 是为以下字段定义的：

    记录 ComputerName 字段
    记录 #1 由计算机 C 生成 -
    记录 #2 由计算机 C 生成 -
    记录 #3 由计算机 C 生成 C
    记录 #1 由计算机 B 生成 -
    记录 #2 由计算机 B 生成 -
    记录 #3 由计算机 B 生成 B
    记录 #1 由计算机 A 生成 -
    记录 #2 由计算机 A 生成 -
    记录 #3 由计算机 A 生成 -
    链头  

     

  • ProcessID - 生成错误的进程的进程标识符。

  • TimeStamp - 错误发生的时间，以 UTC 格式表示。

  • 生成组件 - 生成错误的逻辑组件的整数代码定义。 当前定义了以下组件：

    代码 名称 说明
    1 应用程序 拥有特定 RPC 调用的管理器例程的组件
    2 运行时 RPC 运行时
    3 安全提供程序 此调用的安全提供程序。
    4 NPFS NPFS 文件系统
    5 Rdr 重定向程序
    6 Nmp 命名管道系统。 这可以是 NPFS 或 RDR，但在许多情况下，RPC 运行时不知道谁执行了请求的操作，在这种情况下，将返回 NMP。
    7 IO IO 系统或 IO 系统使用的驱动程序。 这可以是 NPFS、RDR 或 Winsock 提供程序。
    8 Winsock Winsock 提供程序
    9 Authz 代码 授权 API。
    10 Lpc 本地过程调用设施。

     

  • 状态 - 层生成或返回的错误代码
  • DetectionLocation - 标识检测到错误的代码位置的唯一编号。 此字段与代码相关联，并将因版本而变化。 将发布最常遇到的检测位置的单独列表。
  • 标志 - 指定记录相关信息的标志。 当前定义的标志是 EEInfoPreviousRecordsMissing 和 EEInfoNextRecordsMissing，分别对应于数值 1 和 2。 如果设置了 EEInfoPreviousRecordsMissing，则缺少该记录之前的一条或多条记录。 如果设置了 EEInfoNextRecordsMissing，则缺少该记录后面的一条或多条记录。 有关记录可能缺失的原因的说明，请参阅 扩展错误信息的可靠性。
  • 最多四个错误参数。 error 参数是一种轻型变体结构，提供有关错误的其他信息。 其他信息取决于错误和检测位置。 参数可以是 ANSI 字符串类型 (LPSTR) 、Unicode String (LPWSTR) 、long value (long) 、short value (short) 、pointer (int64) 或 none。