Skip to main content

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 del título. Agregue los valores del X-token y la firma de la versión Results de la API a los encabezados Authorization y Signature de la llamada HTTPS antes de realizar la solicitud.

Sintaxis

Parámetros

user   _In_
Tipo: XUserHandle
Un identificador al usuario al que corresponde la solicitud web. options   _In_
Tipo: 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*
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 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.

Comentarios

La función XUserGetTokenAndSignatureUtf16Async usa un argumento de enumeración 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. Para recuperar el tamaño de búfer necesario para contener los resultados de la llamada a XUserGetTokenAndSignatureUtf16Async, llame a 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

Consulte también

XUser XUserGetTokenAndSignatureUtf16Result XUserGetTokenAndSignatureUtf16ResultSize
Última modificación el 28 de agosto de 2026