Skip to main content

XStoreGetUserCollectionsIdAsync

Obtient un ID de collections client. Cet ID peut ensuite être utilisé pour valider un droit d’utilisation de l’utilisateur depuis votre propre service au moyen d’un appel B2B. Cette API est utilisée dans le flux décrit dans Gérer les produits à partir de vos services.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Handle de contexte de Store de l’utilisateur, renvoyé par XStoreCreateContext. serviceTicket   _In_z_
Type : char*
Ticket Azure pouvant être utilisé par le service back-end pour autoriser l’utilisateur et le service. Cela vous permet de recevoir du service un ticket que vous pouvez relayer vers vos propres serveurs. Votre serveur peut alors le stocker et l’utiliser pour des appels B2B afin de vérifier la propriété ou d’accorder l’accès. publisherUserId   _In_z_
Type : char*
Chaîne générée par le développeur, destinée à identifier l’utilisateur actuel comme membre ou invité d’un service appartenant au jeu, au développeur ou à l’éditeur. Le contenu de cette chaîne est déterminé par le développeur et peut être laissé vide. async   _Inout_
Type : XAsyncBlock*
XAsyncBlock définissant le travail asynchrone en cours. Le XAsyncBlock peut être utilisé pour interroger l’état de l’appel et récupérer ses résultats. Pour plus d’informations, consultez XAsyncBlock.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Remarques

Sur PC, cette API renvoie les informations de l’utilisateur actuellement connecté au Store, et pas nécessairement celles de l’utilisateur qui joue à votre jeu si les services XBOX sont activés. Si votre titre est sur la console XBOX ou si les services XBOX sont activés sur PC, nous vous recommandons d’effectuer des appels B2B vers les points de terminaison de collections et d’aperçu de licence à l’aide de l’autorisation déléguée XSTS, afin de vous assurer que vous vérifiez les droits d’utilisation de l’utilisateur qui joue activement. Pour récupérer l’ID de collection de l’utilisateur ainsi que le résultat d’exécution de cette fonction, appelez XStoreGetUserCollectionsIdResult après avoir appelé cette fonction. Pour récupérer la taille de l’ID de collection de l’utilisateur, appelez XStoreGetUserCollectionsIdResultSize. Connaître la taille du résultat vous permet de le récupérer plus efficacement. L’extrait de code suivant montre un exemple de récupération d’un ID de collections client.

Configuration requise

En-tête : XStore.h (inclus dans XGameRuntime.h) Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XStore
XStoreGetUserCollectionsIdResult
Gérer les produits à partir de vos services
Last modified on October 6, 2026