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 SeriesDocumentation conceptuelle
Voir aussi
XStoreXStoreGetUserCollectionsIdResult
Gérer les produits à partir de vos services
