Skip to main content

​
XGameActivationRegisterForEvent

Registra um retorno de chamada para eventos de ativação.

​
Sintaxe

​
Parâmetros

queue   _In_opt_
Tipo: XTaskQueueHandle A fila de tarefas que despacha o retorno de chamada do evento. context   _In_opt_
Tipo: void* O contexto passado para o retorno de chamada do evento. callback   _In_
Tipo: XGameActivationCallback* A função de retorno de chamada do evento. token   _Out_
Tipo: XTaskQueueRegistrationToken* Um token da fila de tarefas que representa o registro. Use o token para cancelar o registro do retorno de chamada para eventos de ativação.

​
Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.
Para obter uma lista de códigos de erro, consulte Códigos de erro.

​
Comentários

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.
A função XGameActivationRegisterForEvent usa um XGameActivationCallback como argumento. O retorno de chamada recebe uma estrutura XGameActivationInfo que contém o tipo de ativação e os dados correspondentes. Esta API lida com todos os tipos de ativação, incluindo ativação de protocolo, ativação de arquivo e convites de jogo. Ela substitui as APIs preteridas XGameProtocolRegisterForActivation e XGameInviteRegisterForEvent. Para cancelar o registro de um retorno de chamada para eventos de ativação, chame XGameActivationUnregisterForEvent. Para obter um exemplo de como chamar esta função, consulte a seção de comentários do tópico XGameActivationCallback.

​
Requisitos

Cabeçalho: XGameActivation.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

​
Documentação conceitual

​
Confira também

XGameActivation XGameActivationCallback XGameActivationUnregisterForEvent
Last modified on October 6, 2026