Skip to main content

XUserGetTokenAndSignatureAsync

API que recupera de forma assíncrona o X-token e a Assinatura necessários para autorizar uma chamada HTTPS para a URL de destino. Retorna um X-token e uma Assinatura se houver uma Terceira Parte Confiável vinculada à URL de destino na página de Logon Único do título no Partner Center. Adicione os valores de X-token e Assinatura da versão Results da API aos cabeçalhos Authorization e Signature da chamada HTTPS antes de fazer a solicitação.

Sintaxe

Parâmetros

user   _In_
Tipo: XUserHandle
Um identificador para o usuário ao qual a solicitação da Web se destina. options   _In_
Tipo: XUserGetTokenAndSignatureOptions
Opções para recuperar o token e a assinatura do usuário. method   _In_z_
Tipo: char*
O tipo de método da solicitação da Web. url   _In_z_
Tipo: char*
A URL de destino da sua solicitação HTTPS. Use a cadeia de caracteres de URL completa para a solicitação HTTPS. Não abrevie a URL. headerCount   _In_
Tipo: size_t
O número de cabeçalhos no parâmetro headers. headers   _In_reads_opt_(headerCount)
Tipo: XUserGetTokenAndSignatureHttpHeader*
Cabeçalhos da solicitação da Web. bodySize   _In_
Tipo: size_t
O tamanho do buffer no parâmetro bodyBuffer. bodyBuffer   _In_reads_bytes_opt_(bodySize)
Tipo: void*
Um buffer que contém o corpo da solicitação da Web. async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock para sondar o status da chamada e recuperar os resultados da chamada.

Valor retornado

Tipo: HRESULT Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, confira Códigos de erro.

Comentários

Para recuperar o resultado da chamada de XUserGetTokenAndSignatureAsync, chame XUserGetTokenAndSignatureResult. Para recuperar o tamanho do buffer necessário para armazenar os resultados da chamada de XUserGetTokenAndSignatureAsync, chame XUserGetTokenAndSignatureResultSize. O exemplo a seguir demonstra como recuperar de forma assíncrona o token e a Assinatura de um usuário.

Requisitos

Cabeçalho: XUser.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, Steam Deck, consoles da família XBOX One e consoles XBOX Series

Confira também

XUser XUserGetTokenAndSignatureResult XUserGetTokenAndSignatureResultSize
Last modified on October 6, 2026