Skip to main content

XStoreCanAcquireLicenseForStoreIdAsync

Recupera una licencia de vista previa para contenido con licencia, incluidos los duraderos con o sin paquetes y el contenido de un disco insertado actualmente. Esta API permite que el juego compruebe si se puede conceder una licencia para el producto, pero sin adquirir realmente la licencia.

Sintaxis

Parámetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
El identificador de contexto de la tienda para el usuario, devuelto por XStoreCreateContext. storeProductId   _In_z_
Tipo: char*
StoreID del producto que se va a comprobar 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. Para obtener más información, consulte XAsyncBlock.

Valor devuelto

Tipo: HRESULT HRESULT de éxito o código de error.

Comentarios

XStoreCanAcquireLicenseForStoreIdAsync ofrece al juego la capacidad de determinar si el usuario podría adquirir una licencia para un contenido concreto sin adquirir realmente esa licencia y sin consumir la ranura de simultaneidad de ese usuario. No es necesario usar esta función para el juego que se está ejecutando actualmente, ya que este ya tiene una licencia, pero puede determinar si el usuario posee otros juegos o contenido del mismo publicador. Por ejemplo, un juego puede usar esta API para determinar si debe recompensar a los usuarios que poseen versiones anteriores del juego (ya sea digitalmente o desde un disco insertado) o para ofrecer productos adicionales al usuario. Para recuperar la licencia de vista previa y el resultado de la ejecución de esta función, llame a XStoreCanAcquireLicenseForStoreIdResult después de llamar a esta función. Este fragmento de código muestra un ejemplo de uso de las siguientes API:

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
XStoreCanAcquireLicenseForStoreIdResult
Cómo usar un duradero sin paquete
Concesión a los jugadores de acceso a contenido de complementos
Última modificación el 28 de agosto de 2026