---
title: BioPutWithCopyFree
description: "对象免拷贝写入接口。"
url: https://www.hikunpeng.com/document/detail/zh/boostsds/BoostIO/kunpengboostIO_020.html
sourcePath: /source/zh/boostsds/BoostIO/kunpengboostIO_020.html
indexId: e2326f9b7898ee23ee831c65221e2525b4b2beaefe3438ec5f3e811d1960e6a451
---
# BioPutWithCopyFree

#### 函数定义

对象免拷贝写入接口。


#### 实现方法

CResult BioPutWithCopyFree(uint64_t tenantId, const char *key, CacheSpaceDesc *space)


#### 参数说明


**表1 参数说明**

| 参数名 | 数据类型 | 参数类型 | 描述 |
| --- | --- | --- | --- |
| tenantId | uint64\_t | 入参 | 租户ID。 |
| key | const char \* | 入参 | 对象的key。 |
| space | CacheSpaceDesc\* | 入参 | 调用BioAllocCacheSpace成功后返回的缓存空间，所有CacheAddress address[CACHE\_SPACE\_ADDRESS\_SIZE]中的size和最大值为4,194,304（4M）。 缓存空间信息描述： uint8\_t allocLoc; 申请标记。 uint16\_t addressNum; 地址数量。 uint16\_t descriptorSize; 缓存空间描述长度。 ObjLocation loc; 缓存空间位置。 CacheAddress address[CACHE\_SPACE\_ADDRESS\_SIZE]; 缓存空间地址信息： uint64\_t address; 缓存地址。 uint32\_t size; 缓存长度。 char descriptorInfo[CACHE\_SPACE\_DEC\_SIZE]; 缓存空间描述信息。 |


#### 返回值


**表2 返回值说明**

| 返回值 | 描述 |
| --- | --- |
| RET\_CACHE\_OK | 操作成功。 |
| RET\_CACHE\_NOT\_FOUND | Cache实例不存在。 |
| RET\_CACHE\_EPERM | 传入参数错误。 |
| RET\_CACHE\_NOT\_READY | BoostIO服务未就绪。 |
| RET\_CACHE\_NEED\_RETRY | 需要外部重试。 |
| RET\_CACHE\_PT\_FAULT | 分区错误，对象位置无法写入。 |
| RET\_CACHE\_ERROR | 操作失败。 |