Skip to main content

XStoreGetUserPurchaseIdAsync

Obtiene un identificador de compra del cliente. Este identificador recupera una clave de identificador de Microsoft Store que se puede usar para conceder derechos de productos gratuitos en nombre del usuario actual. Esta API se usa en el flujo descrito en Administración de productos desde sus servicios

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador del contexto de la tienda para el usuario devuelto por XStoreCreateContext. serviceTicket   _In_z_
Tipo: char*
El vale de servicio asociado a la compra. publisherUserId   _In_z_
Tipo: char*
Una cadena que contiene el identificador de usuario del editor. async   _Inout_
Tipo: XAsyncBlock*
Un XAsyncBlock que define el trabajo asincrónico que se está realizando. El XAsyncBlock se puede usar para sondear el estado de la llamada y recuperar los resultados de la llamada. Consulte XAsyncBlock para obtener más información.

Valor devuelto

Tipo: HRESULT HRESULT de operación correcta o código de error.

Comentarios

Para recuperar el identificador de compra del cliente, así como el resultado de la ejecución de esta función, llame a XStoreGetUserPurchaseIdResult después de llamar a esta función. Para recuperar el tamaño del identificador de compra del cliente, llame a XStoreGetUSerPurchaseIdResultSize después de llamar a esta función. Conocer el tamaño del resultado le ayudará a leer el resultado de forma más eficiente. El siguiente fragmento de código muestra un ejemplo de recuperación de un identificador de compra del cliente.

Requisitos

Encabezado: XStore.h (incluido en XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XStore
XStoreGetUserPurchaseIdResult
XStoreGetUSerPurchaseIdResultSize
Administración de productos desde sus servicios
Última modificación el 28 de agosto de 2026