XStoreGetUserCollectionsIdAsync
Obtient un ID de collections du client. Cet ID peut ensuite servir à valider le droit d’utilisation d’un utilisateur à partir de 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 Le handle de contexte de magasin de l’utilisateur retourné par XStoreCreateContext. serviceTicket _In_z_
Type : char* Un ticket Azure qui peut être utilisé par le service principal pour autoriser l’utilisateur et le service. Cela vous permet d’obtenir en retour un ticket du service, que vous pouvez relayer à vos propres serveurs. Votre serveur peut ensuite 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* Une chaîne générée par le développeur qui sert à 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* Un XAsyncBlock qui définit le travail asynchrone en cours. Le XAsyncBlock peut servir à interroger l’état de l’appel et à récupérer les résultats de l’appel. Pour plus d’informations, consultez XAsyncBlock.
Valeur de retour
Type : HRESULT Code de réussite ou d’erreur HRESULT.Remarques
Sur PC, cette API retourne les informations de l’utilisateur actuellement connecté au magasin, et pas nécessairement de l’utilisateur qui joue à votre jeu si les XBOX services sont activés. Si votre titre est sur la console XBOX ou si les XBOX services sont activés sur PC, nous recommandons d’effectuer des appels B2B vers les points de terminaison de collections et d’aperçu de licence au moyen de l’autorisation déléguée XSTS, afin de vous assurer de vérifier 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 du 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 SeriesDocumentation conceptuelle
Voir aussi
XStoreXStoreGetUserCollectionsIdResult
Gérer les produits à partir de vos services
