Skip to main content

XUserGetTokenAndSignatureAsync

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. Devuelve 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: char*
El tipo de método para la solicitud web. url   _In_z_
Tipo: char*
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: XUserGetTokenAndSignatureHttpHeader*
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

Para recuperar el resultado de la llamada a XUserGetTokenAndSignatureAsync, llame a XUserGetTokenAndSignatureResult. Para recuperar el tamaño de búfer necesario para contener los resultados de la llamada a XUserGetTokenAndSignatureAsync, llame a XUserGetTokenAndSignatureResultSize. El ejemplo siguiente muestra cómo recuperar de forma asincrónica el token y la firma de un usuario.

Requisitos

Encabezado: XUser.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, Steam Deck, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

XUser XUserGetTokenAndSignatureResult XUserGetTokenAndSignatureResultSize
Última modificación el 28 de agosto de 2026