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

# XblTitleStorageDownloadBlobAsync

> XblTitleStorageDownloadBlobAsync

# XblTitleStorageDownloadBlobAsync

Télécharge les données d'un objet blob à partir du stockage de titre.

## Syntaxe

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

### Paramètres

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

Handle de contexte Xbox Live créé avec XblContextCreateHandle.

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

Métadonnées de l'objet blob du stockage de titre à télécharger.

*blobBuffer*   \_Out\_writes\_(blobBufferCount)\
Type : uint8\_t\*

Mémoire tampon allouée par l'appelant qui renvoie les données de l'objet blob téléchargé. Cette mémoire tampon doit être suffisamment grande pour stocker l'objet blob en cours de téléchargement. Si nécessaire, la longueur requise pour la mémoire tampon peut être récupérée en obtenant les métadonnées de l'objet blob.

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

Longueur de blobBuffer.

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

Condition de correspondance ETag utilisée pour déterminer si l'objet blob doit être téléchargé.

*selectQuery*   \_In\_opt\_z\_\
Type : char\*

Chaîne de filtre ConfigStorage ou chaîne de nom de propriété JSON JSONStorage à filtrer. (Facultatif)

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

Taille de bloc de téléchargement préférée, en octets, pour les objets blob binaires. Passez 0 pour utiliser la taille par défaut. (Facultatif)

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

AsyncBlock alloué par l'appelant.

### Valeur de retour

Type : HRESULT

Code de retour HRESULT pour cette opération d'API.

## Remarques

Pour obtenir le résultat, appelez [XblTitleStorageDownloadBlobResult](/fr/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult) dans le rappel AsyncBlock ou une fois l'AsyncBlock terminé. Cette méthode retourne E\_NOT\_SUFFICIENT\_BUFFER (0x8007007A) si blobBuffer n'a pas une capacité suffisante pour contenir les données de l'objet blob.

## Appel REST

V1 GET trustedplatform/users/xuid({xuid})/scids/{scid}/data/{path},{type}\
V1 GET json/users/xuid({xuid})/scids/{scid}/data/{path},{type}\
V1 GET global/scids/{scid}/data/{path},{type}\
V1 GET sessions/{sessionId}/scids/{scid}/data/{path},{type}

## Configuration requise

**En-tête :** title\_storage\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Voir aussi

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


## Related topics

- [XblTitleStorageDownloadBlobAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
- [Downloading a blob from Title Storage](/services/xbox-services/storage/title-storage/how-to/live-downloading-title-storage-blob.md)
- [XblTitleStorageDownloadBlobResult](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobresult.md)