Skip to main content

XblTitleStorageUploadBlobAsync

타이틀 저장소에 blob 데이터를 업로드합니다.

Syntax

Parameters

xboxLiveContext   _In_
Type: XblContextHandle
XblContextCreateHandle로 생성된 XBOX live 컨텍스트 핸들입니다. blobMetadata   _In_
Type: XblTitleStorageBlobMetadata
버퍼를 타이틀 저장소에 업로드하는 데 필요한 속성을 포함합니다. 업로드에는 최소한 서비스 구성 ID, blob 경로, blob 유형 및 저장소 유형이 필요합니다. blobBuffer   _In_
Type: uint8_t*
업로드할 blob 데이터를 포함하는 버퍼입니다. 이 버퍼는 비동기 작업이 진행되는 동안 사용 가능해야 합니다. 클라이언트는 업로드가 진행 중인 동안 버퍼를 수정해서는 안 됩니다. blobBufferCount   _In_
Type: size_t
blobBuffer의 길이입니다. etagMatchCondition   _In_
Type: 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()/scids//data/,
V1 PUT global/scids//data/,
V1 PUT sessions//scids//data/,

Requirements

Header: title_storage_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

See also

title_storage_c
마지막 수정일 2026년 8월 24일