Skip to main content

XNetworkingUnregisterConnectivityHintChanged

Cancela o registro de uma função de retorno de chamada que foi registrada com XNetworkingRegisterConnectivityHintChanged.

Sintaxe

Parâmetros

token   _In_
Tipo: XTaskQueueRegistrationToken
O token retornado por XNetworkingRegisterConnectivityHintChanged. wait   _In_
Tipo: bool
Indica se deve bloquear até que todos os retornos de chamada pendentes sejam concluídos.

Valor retornado

Tipo: bool Retorna false se wait for false e a chamada de cancelamento de registro estiver pendente. Caso contrário, retorna true.

Comentários

Não é seguro chamar essa função em um thread sensível ao tempo. Para obter mais informações, confira Threads sensíveis ao tempo.
Essa função executa as seguintes ações:
  • O retorno de chamada associado ao token é removido do conjunto de retornos de chamada registrados.
  • Se nenhum retorno de chamada estiver em execução para esse token de retorno de chamada, a chamada retornará true.
  • Se houver retornos de chamada em execução e wait for true, a chamada será bloqueada até que o retorno de chamada em execução seja concluído.
  • Se houver retornos de chamada em execução e wait for false, a chamada não será bloqueada, mas retornará false. Quando o retorno de chamada do token for concluído, o registro do token será cancelado automaticamente.
Essa função não deve ser chamada de dentro de um XNetworkingConnectivityHintChangedCallback se wait for true, pois isso causará um deadlock.
Esse mecanismo permite os seguintes padrões de codificação:
  • Você pode bloquear o cancelamento do registro para garantir que seus retornos de chamada nunca sejam invocados após uma chamada de cancelamento de registro.
  • Você pode optar por não bloquear. Se precisar garantir que seus retornos de chamada sejam concluídos antes de excluir dados, você poderá chamar essa função periodicamente com wait definido como false. Quando ela finalmente retornar true, todos os seus retornos de chamada estarão concluídos e você poderá excluir o estado.
  • Se não importar para o seu retorno de chamada se ele está sendo invocado durante uma chamada de cancelamento de registro, você poderá passar false para wait e ignorar o valor retornado.

Requisitos

Cabeçalho: XNetworking.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XNetworkingRegisterConnectivityHintChanged
XNetworkingGetConnectivityHint
Inicialização e conectividade de rede
XNetworking
Last modified on October 6, 2026