XStoreRegisterPackageLicenseLost
Registra um retorno de chamada para o evento de perda de licença. Use esta API para registrar licenças de duráveis adquiridas por meio de XStoreAcquireLicenseForPackageAsync e XStoreAcquireLicenseForDurablesAsync.Sintaxe
Parâmetros
licenseHandle _In_Tipo: XStoreLicenseHandle O identificador de licença para o qual registrar o retorno de chamada. queue _In_
Tipo: XTaskQueueHandle Fila assíncrona para lidar com o trabalho assíncrono. context _In_opt_
Tipo: void* Contexto definido pelo título a ser passado para o retorno de chamada. callback _In_
Tipo: XStorePackageLicenseLostCallback* O retorno de chamada a ser registrado. token _Out_
Tipo: XTaskQueueRegistrationToken* Em caso de êxito, contém um token usado para identificar o retorno de chamada.
Valor retornado
Tipo: HRESULT Código de êxito ou de erro HRESULT.Comentários
Esta função registra a função de retorno de chamada definida por XStorePackageLicenseLostCallback. A função de retorno de chamada registrada é chamada quando ocorre o próximo evento de perda de licença de durável. A função de retorno de chamada não é chamada durante o registro. Um evento de perda de licença geralmente ocorre quando a conta que fez a compra sai do dispositivo e a licença compartilhada anteriormente não está disponível para o usuário atual. Para evitar um vazamento de memória, você deve chamar XStoreUnregisterPackageLicenseLost quando terminar de usar a função de retorno de chamada. Uma licença de durável pode ser perdida a qualquer momento devido a uma mudança de usuário, mudança de rede, verificação de simultaneidade ou expiração da licença no dispositivo. Um jogo deve se registrar para eventos de perda de licença e tentar readquirir a licença do durável quando o retorno de chamada for disparado. Os eventos de perda de licença podem ajudar a detectar quando o sistema retorna erroneamente ao jogador atual uma licença em cache que pertence a outra conta. Nesses casos, um evento de perda de licença é disparado imediatamente e, quando XStoreAcquireLicense* é chamada novamente, uma nova licença é fornecida. Para obter um exemplo de uso, confira XStoreAcquireLicenseForPackageAsync.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 SeriesDocumentação conceitual
Confira também
XStoreXStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStorePackageLicenseLostCallback
XStoreUnregisterPackageLicenseLost
Conceder aos jogadores acesso ao conteúdo de complementos