> ## 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 des données de 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-CA/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Handle de contexte XBOX Live créé avec XblContextCreateHandle.

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

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

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

Mémoire tampon allouée par l'appelant qui retourne les données de blob téléchargées. Cette mémoire tampon doit être assez grande pour stocker le blob téléchargé. Au besoin, la longueur requise pour la mémoire tampon peut être obtenue en récupérant les métadonnées du blob.

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

Longueur de blobBuffer.

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

Condition de correspondance d'ETag utilisée pour déterminer si le 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 blobs 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-CA/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 du 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-CA/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)