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 SeriesDocumentación conceptual
- Concesión a los jugadores de acceso a contenido complementario
- Habilitación de las pruebas de licencias
- Comprobaciones básicas de DRM y licencias
- Uso de tokens de licencia para validar las licencias en los servicios
