Skip to main content

XStoreQueryLicenseTokenAsync

Proporciona un token web JSON opaco al juego que realiza la llamada, que se puede pasar al servicio del juego para validar los derechos de uso y realizar llamadas B2B. Consulte Información general sobre los tokens de licencia para obtener más información.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador de contexto de la tienda para el usuario devuelto por XStoreCreateContext. productIds   _In_z_count_(productIdsCount)
Tipo: char**
Una matriz de identificadores de producto para los que se van a recuperar tokens. productIdsCount   _In_
Tipo: size_t
El número de identificadores de la matriz que se pasa en productIds. customDeveloperString   _In_z_
Tipo: char*
Un valor que se transmite de ida y vuelta en el token. Por lo general, lo elige el servicio. Puede insertar algo como un userId o un correo electrónico para hacer un seguimiento del token del usuario en el token de licencia. Un token de licencia se usa como un recibo de propiedad. No puede ser nulo ni una cadena vacía. 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 Código de error o de operación correcta HRESULT.

Comentarios

Para recuperar el token web JSON, así como el resultado de la ejecución de esta función, llame a XStoreQueryLicenseTokenResult después de llamar a esta función. Para recuperar el tamaño del token web JSON, llame a XStoreQueryLicenseTokenResultSize después de llamar a esta función. Conocer el tamaño del token le permitirá recuperarlo de forma más eficaz. El token de licencia es un token web JSON codificado en Base64. La carga del token es una cadena codificada en Base64 que se convierte en valores JSON que se pueden usar en el servidor para la validación. El siguiente fragmento de código muestra un ejemplo de cómo recuperar un token de licencia.

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 Información general sobre los tokens de licencia XStoreQueryLicenseTokenResult XStoreQueryLicenseTokenResultSize
Última modificación el 28 de agosto de 2026