Skip to main content

XStoreCreateContext

Cria um contexto da loja para o usuário especificado.

Sintaxe

Parâmetros

user   _In_opt_
Tipo: XUserHandle
O usuário para o qual o contexto da loja será criado.
Este parâmetro é opcional somente para jogos de PC: basta passar um valor nullptr. No PC, o usuário conectado à Microsoft Store é usado automaticamente e este parâmetro é ignorado. Um XUser válido é necessário para jogos de console.
storeContextHandle   _Out_
Tipo: XStoreContextHandle*
Em caso de êxito, contém o contexto da loja criado.

Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.

Comentários

OBSERVAÇÃO: Nos consoles, o XStoreContextHandle criado por esta função é invalidado após um evento de suspensão ou de Quick Resume. Para lidar com essas condições com segurança, recomendamos fechar o XStoreContextHandle e recriá-lo sempre que o jogo for retomado de um estado suspenso.
Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Quando terminar de usar o XStoreContextHandle criado por esta função, você deverá fechá-lo com XStoreCloseContextHandle. Não fechar o identificador causará um vazamento de memória. O contexto da loja é usado para identificar o usuário cujas informações serão recuperadas em várias chamadas da API XStore. O snippet de código a seguir mostra um exemplo de criação de um contexto da loja.

Requisitos

Cabeçalho: XStore.h (incluído em XGameRuntime.h) Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XStore
XStoreCloseContextHandle
XStoreRegisterGameLicenseChanged
Last modified on October 6, 2026