> ## 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 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](/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/single-sign-on/live-single-sign-on) del título. Agregue los valores del X-token y la firma de la [versión Results de la API](/reference/system/xuser/functions/xusergettokenandsignatureutf16result) 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](/reference/system/xuser/enums/xusergettokenandsignatureoptions)

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\*](/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader)

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](/reference/system/xasync/structs/xasyncblock) 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](/reference/errorcodes).

## Comentarios

La función XUserGetTokenAndSignatureUtf16Async usa un argumento de enumeración [XUserGetTokenAndSignatureOptions](/reference/system/xuser/enums/xusergettokenandsignatureoptions) 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](/reference/system/xuser/functions/xusergettokenandsignatureutf16result).

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

## 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](/build/console-features/networking/web-requests/intro-winhttp)
* [Implementación del inicio de sesión del jugador](/services/xbox-services/playfab-integration)

## Consulte también

[XUser](/reference/system/xuser/xuser_members)

[XUserGetTokenAndSignatureUtf16Result](/reference/system/xuser/functions/xusergettokenandsignatureutf16result)

[XUserGetTokenAndSignatureUtf16ResultSize](/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize)


## Related topics

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