Skip to main content

XStoreCreateContext

Crea un contexto de la tienda para el usuario especificado.

Sintaxis

Parámetros

user   _In_opt_
Tipo: XUserHandle
El usuario para el que se creará el contexto de la tienda.
Este parámetro es opcional solo para los juegos de PC: simplemente pase un valor nullptr. En PC se usa automáticamente el usuario que ha iniciado sesión en Microsoft Store y este parámetro se omite. Para los juegos de consola se requiere un XUser válido.
storeContextHandle   _Out_
Tipo: XStoreContextHandle*
Si la llamada se ejecuta correctamente, contiene el contexto de la tienda creado.

Valor devuelto

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

Comentarios

NOTA: En las consolas, el XStoreContextHandle creado por esta función se invalida después de un evento de suspensión o de reanudación rápida. Para controlar estas condiciones de forma segura, se recomienda cerrar un XStoreContextHandle y volver a crearlo cada vez que el juego se reanude desde un estado suspendido.
No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
Cuando haya terminado de usar el XStoreContextHandle creado por esta función, debe cerrarlo con XStoreCloseContextHandle. No cerrar el identificador provocará una pérdida de memoria. El contexto de la tienda se usa para identificar al usuario cuya información se recuperará en varias de las llamadas a la API de XStore. El siguiente fragmento de código muestra un ejemplo de creación de un contexto de la tienda.

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
XStoreCloseContextHandle
XStoreRegisterGameLicenseChanged
Última modificación el 28 de agosto de 2026