rpcErrorAddRecord 函式 (rpcasync.h)
RpcErrorAddRecord 函式會將擴充錯誤資訊新增至擴充錯誤資訊記錄鏈結。
語法
RPC_STATUS RpcErrorAddRecord(
[in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);
參數
[in] ErrorInfo
要加入的錯誤資訊，格式為 RPC_EXTENDED_ERROR_INFO 結構。
傳回值
成功完成會傳回RPC_S_OK。
備註
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) |
| 程式庫 | Rpcrt4.lib |
| Dll | Rpcrt4.dll |