> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblTitleStorageUploadBlobAsync

> XblTitleStorageUploadBlobAsync

# XblTitleStorageUploadBlobAsync

将 Blob 数据上传到标题存储。

## 语法

```cpp theme={null}
HRESULT XblTitleStorageUploadBlobAsync(  
         XblContextHandle xboxLiveContext,  
         XblTitleStorageBlobMetadata blobMetadata,  
         const uint8_t* blobBuffer,  
         size_t blobBufferCount,  
         XblTitleStorageETagMatchCondition etagMatchCondition,  
         size_t preferredUploadBlockSize,  
         XAsyncBlock* async  
)  
```

### 参数

*xboxLiveContext*   \_In\_\
类型：[XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

使用 XblContextCreateHandle 创建的 XBOX Live 上下文句柄。

*blobMetadata*   \_In\_\
类型：[XblTitleStorageBlobMetadata](/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata)

包含将缓冲区上传到标题存储所需的属性。上传至少需要一个服务配置 ID、Blob 路径、Blob 类型和存储类型。

*blobBuffer*   \_In\_\
类型：uint8\_t\*

包含要上传的 Blob 数据的缓冲区。此缓冲区在整个异步操作期间必须可用。客户端不应在上传过程中修改缓冲区。

*blobBufferCount*   \_In\_\
类型：size\_t

blobBuffer 的长度。

*etagMatchCondition*   \_In\_\
类型：[XblTitleStorageETagMatchCondition](/reference/live/xsapi-c/title_storage_c/enums/xbltitlestorageetagmatchcondition)

用于确定是否应上传 Blob 数据的 ETag 匹配条件。

*preferredUploadBlockSize*   \_In\_\
类型：size\_t

二进制 Blob 的首选上传块大小（以字节为单位）。如果二进制 Blob 超过此大小，将以多个此大小的块进行上传。服务首选更大的大小。如果发生超时，应用应使用较小的大小重试。块大小必须在 1K 到 4MB 范围内。如果此参数不在可接受范围内，此方法将使用默认大小。当前最小大小为 1024 字节，最大大小为 4194304 字节，默认大小为 262144 字节。（可选）

*async*   \_In\_\
类型：XAsyncBlock\*

调用方分配的 AsyncBlock。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## REST 调用

V1 PUT json/users/xuid({xuid})/scids/{scid}/data/{path},{type}\
V1 PUT global/scids/{scid}/data/{path},{type}\
V1 PUT sessions/{sessionId}/scids/{scid}/data/{path},{type}

## 要求

**头文件：** title\_storage\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[title\_storage\_c](/reference/live/xsapi-c/title_storage_c/title_storage_c_members)


## Related topics

- [XblTitleStorageUploadBlobResult](/zh-CN/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobresult.md)
- [将 blob 上传到 Title Storage](/zh-CN/services/xbox-services/storage/title-storage/how-to/live-uploading-title-storage-blob.md)
- [XblTitleStorageDeleteBlobAsync](/zh-CN/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedeleteblobasync.md)
- [XblTitleStorageDownloadBlobAsync](/zh-CN/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
- [获取 Title Storage blob 元数据](/zh-CN/services/xbox-services/storage/title-storage/how-to/live-getting-title-storage-blob-metadata.md)