Skip to main content

XUserGetTokenAndSignatureUtf16Async

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. Ela retornará 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: wchar_t*
O tipo de método da solicitação da Web, em Unicode. url   _In_z_
Tipo: wchar_t*
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: XUserGetTokenAndSignatureUtf16HttpHeader*
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

A função XUserGetTokenAndSignatureUtf16Async usa um argumento de enumeração XUserGetTokenAndSignatureOptions para recuperar de forma assíncrona X-tokens e Assinaturas Unicode para solicitações da Web. Para recuperar o resultado da chamada de XUserGetTokenAndSignatureUtf16Async, chame XUserGetTokenAndSignatureUtf16Result. Para recuperar o tamanho do buffer necessário para armazenar os resultados da chamada de XUserGetTokenAndSignatureUtf16Async, chame XUserGetTokenAndSignatureUtf16ResultSize.

Requisitos

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

Documentação conceitual

Confira também

XUser XUserGetTokenAndSignatureUtf16Result XUserGetTokenAndSignatureUtf16ResultSize
Last modified on October 6, 2026