> ## 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.

# XblTitleStorageGetBlobMetadataAsync

> XblTitleStorageGetBlobMetadataAsync

# XblTitleStorageGetBlobMetadataAsync

針對指定的服務設定、儲存類型和儲存識別碼，取得指定路徑下的 Blob 中繼資料物件清單。

## 語法

```cpp theme={null}
HRESULT XblTitleStorageGetBlobMetadataAsync(  
         XblContextHandle xboxLiveContext,  
         const char* serviceConfigurationId,  
         XblTitleStorageType storageType,  
         const char* blobPath,  
         uint64_t xboxUserId,  
         uint32_t skipItems,  
         uint32_t maxItems,  
         XAsyncBlock* async  
)  
```

### 參數

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

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

*serviceConfigurationId*   \_In\_z\_\
類型：char\*

遊戲的服務設定識別碼 (SCID)。SCID 會區分大小寫，因此請直接從 Partner Center 貼上。

*storageType*   \_In\_\
類型：[XblTitleStorageType](/zh-TW/reference/live/xsapi-c/title_storage_c/enums/xbltitlestoragetype)

要取得 Blob 中繼資料物件的儲存類型。

*blobPath*   \_In\_z\_\
類型：char\*

要列舉的根路徑。結果將會是此路徑及所有子路徑中包含的 Blob。(選擇性)

*xboxUserId*   \_In\_\
類型：uint64\_t

要列舉之 Title Storage 的 XBOX 使用者識別碼。列舉 GlobalStorage 時會忽略此值，因此可以傳遞 0。(選擇性)

*skipItems*   \_In\_\
類型：uint32\_t

傳回結果之前要略過的項目數目。(選擇性)

*maxItems*   \_In\_\
類型：uint32\_t

要傳回的項目數目上限。傳遞 0 以嘗試擷取所有項目。(選擇性)

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

呼叫端配置的 AsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

若要取得結果，請在 AsyncBlock 回呼內或在 AsyncBlock 完成後呼叫 XblTitleStorageGetBlobMetadataResult。

## REST 呼叫

V1 GET trustedplatform/users/xuid({xuid})/scids/{scid}/data/{path}?maxItems={maxItems}\[skipItems={skipItems}]\
V1 GET json/users/xuid({xuid})/scids/{scid}/data/{path}?maxItems={maxItems}\[skipItems={skipItems}]\
V1 GET global/scids/{scid}/data/{path}?maxItems={maxItems}\[skipItems={skipItems}]

## 需求

**標頭：** 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

- [XblTitleStorageGetBlobMetadataResult](/zh-TW/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetblobmetadataresult.md)
- [取得遊戲儲存空間 Blob 中繼資料](/zh-TW/services/xbox-services/storage/title-storage/how-to/live-getting-title-storage-blob-metadata.md)
- [XblTitleStorageBlobMetadataResultGetNextAsync](/zh-TW/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageblobmetadataresultgetnextasync.md)
- [XblTitleStorageBlobMetadataResultGetNextResult](/zh-TW/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageblobmetadataresultgetnextresult.md)
- [XblTitleStorageBlobMetadataResultHasNext](/zh-TW/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageblobmetadataresulthasnext.md)