Skip to main content

XStoreQueryLicenseTokenAsync

Fornece ao jogo chamador um JSON Web Token opaco que pode ser passado ao serviço do jogo para validação de direitos e para fazer chamadas B2B. Confira Visão geral dos tokens de licença para obter mais informações.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja para o usuário retornado por XStoreCreateContext. productIds   _In_z_count_(productIdsCount)
Tipo: char**
Uma matriz de IDs de produto para os quais recuperar tokens. productIdsCount   _In_
Tipo: size_t
O número de IDs na matriz passada em productIds. customDeveloperString   _In_z_
Tipo: char*
Um valor que é incluído de ida e volta no token. Geralmente, ele é escolhido pelo serviço. Você pode inserir algo como um userId ou email para rastrear o token do usuário no token de licença. Um token de licença é usado como um comprovante de propriedade. Ele não pode ser nulo nem uma cadeia de caracteres vazia. async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock que define o trabalho assíncrono que está sendo feito. O XAsyncBlock pode ser usado para sondar o status da chamada e recuperar os resultados da chamada. Confira XAsyncBlock para obter mais informações.

Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.

Comentários

Para recuperar o JSON Web Token, bem como o resultado da execução desta função, chame XStoreQueryLicenseTokenResult após chamar esta função. Para recuperar o tamanho do JSON Web Token, chame XStoreQueryLicenseTokenResultSize após chamar esta função. Saber o tamanho do token permitirá que você o recupere com mais eficiência. O token de licença é um JSON Web Token codificado em Base64. O payload do token é uma cadeia de caracteres codificada em Base64 que é convertida em valores JSON que podem ser usados no servidor para validação. O snippet de código a seguir mostra um exemplo de recuperação de um token de licença.

Requisitos

Cabeçalho: XStore.h (incluído em XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XStore Visão geral dos tokens de licença XStoreQueryLicenseTokenResult XStoreQueryLicenseTokenResultSize
Last modified on October 6, 2026