> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/single-sign-on/live-single-sign-on.md). Adicione os valores de X-token e Assinatura da [versão Results da API](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md) 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](https://docs.xbox.com/pt-BR/reference/system/xuser/enums/xusergettokenandsignatureoptions.md)

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\*](https://docs.xbox.com/pt-BR/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader.md)

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](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md) 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](https://docs.xbox.com/pt-BR/reference/errorcodes.md).

## Comentários

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

Para recuperar o tamanho do buffer necessário para armazenar os resultados da chamada de XUserGetTokenAndSignatureUtf16Async, chame [XUserGetTokenAndSignatureUtf16ResultSize](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize.md).

## 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](https://docs.xbox.com/pt-BR/build/console-features/networking/web-requests/intro-winhttp.md)
* [Implementar a entrada do jogador](https://docs.xbox.com/pt-BR/services/xbox-services/playfab-integration.md)

## Confira também

[XUser](https://docs.xbox.com/pt-BR/reference/system/xuser/xuser_members.md)

[XUserGetTokenAndSignatureUtf16Result](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md)

[XUserGetTokenAndSignatureUtf16ResultSize](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize.md)


## Related topics

- [XUserGetTokenAndSignatureUtf16Result](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md)
- [XUserGetTokenAndSignatureUtf16ResultSize](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize.md)
- [XUserGetTokenAndSignatureUtf16Data](https://docs.xbox.com/pt-BR/reference/system/xuser/structs/xusergettokenandsignatureutf16data.md)
- [XUserGetTokenAndSignatureUtf16HttpHeader](https://docs.xbox.com/pt-BR/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader.md)
- [XUserGetTokenAndSignatureOptions](https://docs.xbox.com/pt-BR/reference/system/xuser/enums/xusergettokenandsignatureoptions.md)