RpcErrorSaveErrorInfo 函数 (rpcasync.h)

RpcErrorSaveErrorInfo 函数以 BLOB 的形式返回枚举句柄的所有错误信息。

语法

RPC_STATUS RpcErrorSaveErrorInfo(
  [in]  RPC_ERROR_ENUM_HANDLE *EnumHandle,
  [out] PVOID                 *ErrorBlob,
  [out] size_t                *BlobSize
);

参数

[in] EnumHandle

指向枚举句柄的指针。

[out] ErrorBlob

指向包含错误信息的 BLOB 的指针。

[out] BlobSize

ErrorBlob 的大小(以字节为单位)。

返回值

成功完成将返回RPC_S_OK。 如果没有足够的内存可用, RpcErrorSaveErrorInfo 函数调用可能会失败。

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

注解

BLOB 在系统堆上分配,调用方是缓冲区的所有者。 在系统堆上分配的块可能大于 BlobSize,但只使用 BlobSizeRpcErrorSaveErrorInfo 函数将保存与枚举句柄关联的整个扩展错误信息记录链,而不考虑游标位置,并且不会更改枚举的游标位置。

BLOB 可以保存并稍后使用 RpcErrorLoadErrorInfo 函数检索。

要求

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

另请参阅

获取扩展 RPC 错误信息

RPC_ERROR_ENUM_HANDLE

RpcErrorLoadErrorInfo

RpcErrorStartEnumeration