RpcErrorAddRecord 函数 (rpcasync.h)

  • 项目

RpcErrorAddRecord 函数将扩展错误信息添加到扩展错误信息记录链。

语法

RPC_STATUS RpcErrorAddRecord(
  [in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);

参数

[in] ErrorInfo

要添加的错误信息，采用 RPC_EXTENDED_ERROR_INFO 结构的形式。

返回值

成功完成将返回RPC_S_OK。

注意 有关有效错误代码的列表，请参阅 RPC 返回值。
 

注解

RpcErrorAddRecord 函数使 RPC 运行时以外的应用程序或服务器能够将扩展错误信息添加到扩展错误信息记录链。

ErrorInfo 指向的字符串的责任属于调用方;RpcErrorAddRecord 函数会根据需要复制这些字符串。 必须遵守对 ErrorInfo 成员的以下限制：

版本 必须设置为有效版本，例如RPC_EEINFO_VERSION。

ComputerName 必须设置为 NULL。 任何其他值都会导致ERROR_INVALID_PARAMETER。

ProcessID 必须设置为零。 任何其他值都会导致ERROR_INVALID_PARAMETER。

输入时将忽略 SystemTime 或 FileTime，并由 RPC 运行时设置。

GeneratingComponent 必须设置为零。 任何其他值都会导致ERROR_INVALID_PARAMETER。 RPC 运行时将此设置为 EEInfoGCApplication。

状态 可以设置为调用方要添加到链中的错误代码。

DetectionLocation 必须设置为零。 任何其他值都会导致ERROR_INVALID_PARAMETER。

NumberOfParameters 指示 Parameters 数组中的参数数。 此值必须等于或大于零或 MaxNumberOfEEInfoParams。 RPC 运行时在指定数量的参数后不使用任何内存，因此调用方可以安全地为小于 MaxNumberOfEEInfoParams 参数分配内存。

参数 表示扩展错误信息记录的参数。 参数的唯一限制是 Pval 用于表示指针，并且始终为 64 位。 无论使用的系统是 32 位还是 64 位，都使用 Pval 。 请勿使用 Lval。

要求

要求 值
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 rpcasync.h (包括 Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

另请参阅

获取扩展 RPC 错误信息

RPC_EXTENDED_ERROR_INFO

RpcErrorGetNextRecord

RpcErrorStartEnumeration