Skip to main content

XStoreGetUserCollectionsIdAsync

Obtém uma ID de coleções do cliente. Essa ID pode então ser usada para validar o direito de um usuário a partir do seu próprio serviço com uma chamada B2B. Esta API é usada no fluxo descrito em Gerenciar produtos de seus serviços.

Sintaxe

Parâmetros

storeContextHandle   _In_
Tipo: XStoreContextHandle
O identificador de contexto da loja do usuário retornado por XStoreCreateContext. serviceTicket   _In_z_
Tipo: char*
Um tíquete do Azure que pode ser usado pelo serviço de back-end para autorizar o usuário e o serviço. Isso permite obter de volta um tíquete do serviço, que você pode retransmitir para seus próprios servidores. Em seguida, seu servidor pode armazená-lo e usá-lo em chamadas B2B para verificar a propriedade ou conceder acesso. publisherUserId   _In_z_
Tipo: char*
Uma cadeia de caracteres gerada pelo desenvolvedor destinada a identificar o usuário atual como membro ou convidado de um serviço que pertence ao jogo, ao desenvolvedor ou ao editor. O conteúdo dessa cadeia de caracteres é determinado pelo desenvolvedor e pode ser deixado em branco. async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock que define o trabalho assíncrono que está sendo feito. O XAsyncBlock pode ser usado para sondar o status da chamada e recuperar os resultados da chamada. Consulte XAsyncBlock para obter mais informações.

Valor retornado

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

Comentários

No PC, esta API retornará informações do usuário conectado no momento à loja e não necessariamente do usuário que está jogando seu jogo, se os XBOX services estiverem habilitados. Se o seu título estiver no console XBOX ou tiver os XBOX services habilitados no PC, recomendamos fazer chamadas B2B para os pontos de extremidade de coleções e de visualização de licença usando a autorização delegada XSTS, para garantir que você esteja verificando os direitos do usuário que está jogando ativamente. Para recuperar a ID de coleção do usuário, bem como o resultado da execução desta função, chame XStoreGetUserCollectionsIdResult após chamar esta função. Para recuperar o tamanho da ID de coleção do usuário, chame XStoreGetUserCollectionsIdResultSize. Saber o tamanho do resultado permitirá que você o recupere com mais eficiência. O snippet de código a seguir mostra um exemplo de recuperação de uma ID de coleções do cliente.

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
XStoreGetUserCollectionsIdResult
Gerenciar produtos de seus serviços
Last modified on October 6, 2026