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.
- 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.
- 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 SeriesDocumentação conceitual
Confira também
XNetworkingRegisterConnectivityHintChangedXNetworkingGetConnectivityHint
Inicialização e conectividade de rede
XNetworking
