> ## 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 데이터를 업로드합니다.

## Syntax

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

### Parameters

*xboxLiveContext*   \_In\_\
Type: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

XblContextCreateHandle로 생성된 XBOX live 컨텍스트 핸들입니다.

*blobMetadata*   \_In\_\
Type: [XblTitleStorageBlobMetadata](/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata)

버퍼를 타이틀 저장소에 업로드하는 데 필요한 속성을 포함합니다. 업로드에는 최소한 서비스 구성 ID, blob 경로, blob 유형 및 저장소 유형이 필요합니다.

*blobBuffer*   \_In\_\
Type: uint8\_t\*

업로드할 blob 데이터를 포함하는 버퍼입니다. 이 버퍼는 비동기 작업이 진행되는 동안 사용 가능해야 합니다. 클라이언트는 업로드가 진행 중인 동안 버퍼를 수정해서는 안 됩니다.

*blobBufferCount*   \_In\_\
Type: size\_t

blobBuffer의 길이입니다.

*etagMatchCondition*   \_In\_\
Type: [XblTitleStorageETagMatchCondition](/reference/live/xsapi-c/title_storage_c/enums/xbltitlestorageetagmatchcondition)

blob 데이터 업로드 여부를 결정하는 데 사용되는 ETag 일치 조건입니다.

*preferredUploadBlockSize*   \_In\_\
Type: size\_t

바이너리 blob의 기본 업로드 블록 크기(바이트)입니다. 바이너리 blob이 이 크기를 초과하면 여러 청크로 나뉘어 이 크기로 업로드됩니다. 큰 크기가 서비스에서 선호됩니다. 시간 초과가 발생하는 경우 앱은 더 작은 크기로 다시 시도해야 합니다. 블록 크기는 1K에서 4MB 범위 내에 있어야 합니다. 이 매개 변수가 허용 범위를 벗어난 경우 이 메서드는 기본 크기를 사용합니다. 현재 최소 크기는 1024바이트, 최대 크기는 4194304바이트, 기본 크기는 262144바이트입니다. (선택 사항)

*async*   \_In\_\
Type: XAsyncBlock\*

호출자가 할당한 AsyncBlock입니다.

### Return value

Type: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

## REST Call

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}

## Requirements

**Header:** title\_storage\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## See also

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


## Related topics

- [XblTitleStorageUploadBlobResult](/ko/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobresult.md)
- [Title Storage에 블롭 업로드](/ko/services/xbox-services/storage/title-storage/how-to/live-uploading-title-storage-blob.md)
- [XblTitleStorageDownloadBlobAsync](/ko/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
- [XblTitleStorageDeleteBlobAsync](/ko/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedeleteblobasync.md)
- [XblTitleStorageDownloadBlobResult](/ko/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult.md)