Skip to main content

XblTitleStorageDownloadBlobAsync

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

Syntaxe

Paramètres

xboxLiveContext   _In_
Type : XblContextHandle
Handle de contexte Xbox Live créé avec XblContextCreateHandle. blobMetadata   _In_
Type : 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
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 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()/scids//data/,
V1 GET json/users/xuid()/scids//data/,
V1 GET global/scids//data/,
V1 GET sessions//scids//data/,

Configuration requise

En-tête : title_storage_c.h Bibliothèque : Microsoft.Xbox.Services.14x.GDK.C.lib

Voir aussi

title_storage_c
Last modified on October 6, 2026