> ## 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](/zh-TW/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

使用 XblContextCreateHandle 建立的 XBOX Live 內容控制代碼。

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

包含將緩衝區上傳至遊戲儲存體所需的屬性。上傳至少需要服務設定識別碼、Blob 路徑、Blob 類型和儲存體類型。

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

包含要上傳之 Blob 資料的緩衝區。此緩衝區在非同步作業期間必須保持可用。用戶端不應在上傳進行中修改緩衝區。

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

blobBuffer 的長度。

*etagMatchCondition*   \_In\_\
類型：[XblTitleStorageETagMatchCondition](/zh-TW/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](/zh-TW/reference/live/xsapi-c/title_storage_c/title_storage_c_members)


## Related topics

- [XblTitleStorageUploadBlobAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobasync.md)
- [Uploading a blob to Title Storage](/services/xbox-services/storage/title-storage/how-to/live-uploading-title-storage-blob.md)
- [XblTitleStorageUploadBlobResult](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobresult.md)