> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUserGetTokenAndSignatureUtf16Async

> XUserGetTokenAndSignatureUtf16Async

# 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](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/single-sign-on/live-single-sign-on). Adicione os valores de X-token e Assinatura da [versão Results da API](/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16result) aos cabeçalhos Authorization e Signature da chamada HTTPS antes de fazer a solicitação.

## Sintaxe

```cpp theme={null}
HRESULT XUserGetTokenAndSignatureUtf16Async(  
         XUserHandle user,  
         XUserGetTokenAndSignatureOptions options,  
         const wchar_t* method,  
         const wchar_t* url,  
         size_t headerCount,  
         const XUserGetTokenAndSignatureUtf16HttpHeader* headers,  
         size_t bodySize,  
         const void* bodyBuffer,  
         XAsyncBlock* async  
)  
```

### 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](/pt-BR/reference/system/xuser/enums/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\*](/pt-BR/reference/system/xuser/structs/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](/pt-BR/reference/system/xasync/structs/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](/pt-BR/reference/errorcodes).

## Comentários

A função XUserGetTokenAndSignatureUtf16Async usa um argumento de enumeração [XUserGetTokenAndSignatureOptions](/pt-BR/reference/system/xuser/enums/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](/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16result).

Para recuperar o tamanho do buffer necessário para armazenar os resultados da chamada de XUserGetTokenAndSignatureUtf16Async, chame [XUserGetTokenAndSignatureUtf16ResultSize](/pt-BR/reference/system/xuser/functions/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

* [Visão geral do WinHTTP](/pt-BR/build/console-features/networking/web-requests/intro-winhttp)
* [Implementar a entrada do jogador](/pt-BR/services/xbox-services/playfab-integration)

## Confira também

[XUser](/pt-BR/reference/system/xuser/xuser_members)

[XUserGetTokenAndSignatureUtf16Result](/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16result)

[XUserGetTokenAndSignatureUtf16ResultSize](/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize)


## Related topics

- [XUserGetTokenAndSignatureUtf16Async](/reference/system/xuser/functions/xusergettokenandsignatureutf16async.md)
- [XUserGetTokenAndSignatureUtf16Result](/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md)
- [XUserGetTokenAndSignatureUtf16ResultSize](/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize.md)
- [XUserGetTokenAndSignatureUtf16Data](/reference/system/xuser/structs/xusergettokenandsignatureutf16data.md)