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 SeriesDocumentación conceptual
Consulte también
XStoreXStoreGetUserCollectionsIdResult
Administración de productos desde sus servicios
