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,但只使用 BlobSize 。 RpcErrorSaveErrorInfo 函数将保存与枚举句柄关联的整个扩展错误信息记录链,而不考虑游标位置,并且不会更改枚举的游标位置。
BLOB 可以保存并稍后使用 RpcErrorLoadErrorInfo 函数检索。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | rpcasync.h (包括 Rpc.h) |
Library | Rpcrt4.lib |
DLL | Rpcrt4.dll |