Skip to main content

XStoreGetUserCollectionsIdAsync

Obtiene un identificador de colecciones del cliente. Este identificador se puede usar después para validar el derecho de un usuario desde su propio servicio con una llamada B2B. Esta API se usa en el flujo descrito en Administración de productos desde sus servicios.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador del contexto de la tienda para el usuario devuelto por XStoreCreateContext. serviceTicket   _In_z_
Tipo: char*
Un vale de Azure que puede usar el servicio de back-end para autorizar al usuario y al servicio. Esto le permite recibir un vale del servicio, que puede retransmitir a sus propios servidores. Su servidor puede almacenarlo y usarlo para llamadas B2B, ya sea para comprobar la propiedad o para conceder acceso. publisherUserId   _In_z_
Tipo: char*
Una cadena generada por el desarrollador destinada a identificar al usuario actual como miembro o invitado de un servicio que pertenece al juego, al desarrollador o al editor. El contenido de esta cadena lo determina el desarrollador y puede dejarse en blanco. async   _Inout_
Tipo: XAsyncBlock*
Un XAsyncBlock que define el trabajo asincrónico que se está realizando. El XAsyncBlock se puede usar para sondear el estado de la llamada y recuperar los resultados de la llamada. Consulte XAsyncBlock para obtener más información.

Valor devuelto

Tipo: HRESULT HRESULT de operación correcta o código de error.

Comentarios

En PC, esta API devolverá información del usuario que ha iniciado sesión actualmente en la tienda y no necesariamente del usuario que está jugando a su juego si los servicios de XBOX están habilitados. Si su título está en la consola XBOX o los servicios de XBOX están habilitados en el PC, se recomienda realizar llamadas B2B a los puntos de conexión de colecciones y vista previa de licencias mediante la autorización delegada XSTS para asegurarse de que está comprobando los derechos del usuario que está jugando activamente. Para recuperar el identificador de colección del usuario, así como el resultado de la ejecución de esta función, llame a XStoreGetUserCollectionsIdResult después de llamar a esta función. Para recuperar el tamaño del identificador de colección del usuario, llame a XStoreGetUserCollectionsIdResultSize. Conocer el tamaño del resultado le permitirá recuperarlo de forma más eficiente. El siguiente fragmento de código muestra un ejemplo de recuperación de un identificador de colecciones del cliente.

Requisitos

Encabezado: XStore.h (incluido en XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XStore
XStoreGetUserCollectionsIdResult
Administración de productos desde sus servicios
Última modificación el 28 de agosto de 2026