> ## 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 asincrónica el X-token y la firma necesarios para autorizar una llamada HTTPS a la dirección URL de destino. Esto devolverá un X-token y una firma si hay un usuario de confianza vinculado a la dirección URL de destino en la [página de inicio de sesión único en Partner Center](https://docs.xbox.com/es/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/single-sign-on/live-single-sign-on.md) del título. Agregue los valores del X-token y la firma de la [versión Results de la API](https://docs.xbox.com/es/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md) a los encabezados Authorization y Signature de la llamada HTTPS antes de realizar la solicitud.

## Sintaxis

```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

Un identificador al usuario al que corresponde la solicitud web.

*options*   \_In\_\
Tipo: [XUserGetTokenAndSignatureOptions](https://docs.xbox.com/es/reference/system/xuser/enums/xusergettokenandsignatureoptions.md)

Opciones para recuperar el token de usuario y la firma.

*method*   \_In\_z\_\
Tipo: wchar\_t\*

El tipo de método para la solicitud web, en Unicode.

*url*   \_In\_z\_\
Tipo: wchar\_t\*

La dirección URL de destino de la solicitud HTTPS. Use la cadena de dirección URL completa para la solicitud HTTPS. No abrevie la dirección URL.

*headerCount*   \_In\_\
Tipo: size\_t

El número de encabezados del parámetro *headers*.

*headers*   \_In\_reads\_opt\_(headerCount)\
Tipo: [XUserGetTokenAndSignatureUtf16HttpHeader\*](https://docs.xbox.com/es/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader.md)

Encabezados para la solicitud web.

*bodySize*   \_In\_\
Tipo: size\_t

El tamaño del búfer del parámetro *bodyBuffer*.

*bodyBuffer*   \_In\_reads\_bytes\_opt\_(bodySize)\
Tipo: void\*

Un búfer que contiene el cuerpo de la solicitud web.

*async*   \_Inout\_\
Tipo: XAsyncBlock\*

Un [XAsyncBlock](https://docs.xbox.com/es/reference/system/xasync/structs/xasyncblock.md) para sondear el estado de la llamada y recuperar los resultados de la llamada.

### Valor devuelto

Tipo: HRESULT

Devuelve S\_OK si se realiza correctamente; de lo contrario, devuelve un código de error.
Para obtener una lista de los códigos de error, consulte [Códigos de error](https://docs.xbox.com/es/reference/errorcodes.md).

## Comentarios

La función XUserGetTokenAndSignatureUtf16Async usa un argumento de enumeración [XUserGetTokenAndSignatureOptions](https://docs.xbox.com/es/reference/system/xuser/enums/xusergettokenandsignatureoptions.md) para recuperar de forma asincrónica X-tokens y firmas Unicode para solicitudes web.

Para recuperar el resultado de la llamada a XUserGetTokenAndSignatureUtf16Async, llame a [XUserGetTokenAndSignatureUtf16Result](https://docs.xbox.com/es/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md).

Para recuperar el tamaño de búfer necesario para contener los resultados de la llamada a XUserGetTokenAndSignatureUtf16Async, llame a [XUserGetTokenAndSignatureUtf16ResultSize](https://docs.xbox.com/es/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize.md).

## Requisitos

**Encabezado:** XUser.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, Steam Deck, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Información general de WinHTTP](https://docs.xbox.com/es/build/console-features/networking/web-requests/intro-winhttp.md)
* [Implementación del inicio de sesión del jugador](https://docs.xbox.com/es/services/xbox-services/playfab-integration.md)

## Consulte también

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

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

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


## Related topics

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