Skip to main content

XStoreGetUserPurchaseIdAsync

Obtém uma ID de compra do cliente. Essa ID recupera uma chave de ID da Microsoft Store que pode ser usada para conceder direitos a produtos gratuitos em nome do usuário atual. 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*
O tíquete de serviço associado à compra. publisherUserId   _In_z_
Tipo: char*
Uma cadeia de caracteres que contém a ID de usuário do editor. 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

Para recuperar a ID de compra do cliente, bem como o resultado da execução desta função, chame XStoreGetUserPurchaseIdResult após chamar esta função. Para recuperar o tamanho da ID de compra do cliente, chame XStoreGetUSerPurchaseIdResultSize após chamar esta função. Saber o tamanho do resultado ajudará você a lê-lo com mais eficiência. O snippet de código a seguir mostra um exemplo de recuperação de uma ID de compra 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
XStoreGetUserPurchaseIdResult
XStoreGetUSerPurchaseIdResultSize
Gerenciar produtos de seus serviços
Last modified on October 6, 2026