Skip to main content

XblTitleStorageDownloadBlobAsync

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

Syntax

Parameters

xboxLiveContext   _In_
Type: XblContextHandle
XblContextCreateHandle로 생성된 XBOX live 컨텍스트 핸들입니다. blobMetadata   _In_
Type: XblTitleStorageBlobMetadata
다운로드할 타이틀 저장소 blob의 blob 메타데이터입니다. blobBuffer   _Out_writes_(blobBufferCount)
Type: uint8_t*
다운로드한 blob 데이터를 다시 전달하는 호출자가 할당한 버퍼입니다. 이 버퍼는 다운로드하는 blob을 저장할 수 있을 만큼 충분히 커야 합니다. 필요한 경우 blob 메타데이터를 가져와 버퍼에 필요한 길이를 조회할 수 있습니다. blobBufferCount   _In_
Type: size_t
blobBuffer의 길이입니다. etagMatchCondition   _In_
Type: XblTitleStorageETagMatchCondition
blob 다운로드 여부를 결정하는 데 사용되는 ETag 일치 조건입니다. selectQuery   _In_opt_z_
Type: char*
필터링할 ConfigStorage 필터 문자열 또는 JSONStorage json 속성 이름 문자열입니다. (선택 사항) preferredDownloadBlockSize   _In_
Type: size_t
바이너리 blob의 기본 다운로드 블록 크기(바이트)입니다. 기본 크기를 사용하려면 0을 전달합니다. (선택 사항) async   _In_
Type: XAsyncBlock*
호출자가 할당한 AsyncBlock입니다.

Return value

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

Remarks

결과를 얻으려면 AsyncBlock 콜백 내부 또는 AsyncBlock이 완료된 후에 XblTitleStorageDownloadBlobResult를 호출합니다. blobBuffer가 blob 데이터를 저장할 만큼 충분한 용량을 갖지 않는 경우 이 메서드는 E_NOT_SUFFICIENT_BUFFER(0x8007007A)를 반환합니다.

REST Call

V1 GET trustedplatform/users/xuid()/scids//data/,
V1 GET json/users/xuid()/scids//data/,
V1 GET global/scids//data/,
V1 GET 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일