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)
程式庫 Rpcrt4.lib
Dll Rpcrt4.dll

另請參閱

取得擴充 RPC 錯誤資訊

RPC_ERROR_ENUM_HANDLE

RpcErrorLoadErrorInfo

RpcErrorStartEnumeration