XUserUnregisterForChangeEvent
Cancela o registro de um retorno de chamada de alteração de usuário registrado anteriormente.Sintaxe
Parâmetros
token _In_Tipo: XTaskQueueRegistrationToken Um token retornado por XUserRegisterForChangeEvent, que identifica o retorno de chamada cujo registro deve ser cancelado. wait _In_
Tipo: bool Indica se deve haver bloqueio até que todos os retornos de chamada pendentes sejam concluídos.
Valor retornado
Tipo: bool Retorna false se wait for false e o cancelamento do registro estiver pendente. Caso contrário, retorna true.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.
- Se os retornos de chamada não estiverem em execução para o token de retorno de chamada, a chamada retornará true.
- Se os retornos de chamada estiverem em execução e wait for true, a chamada será bloqueada até que o retorno de chamada em execução seja concluído.
- Se os retornos de chamada estiverem em execução e wait for false, a chamada não será bloqueada, mas retornará false. Depois que o retorno de chamada do token for concluído, o registro do token será cancelado automaticamente.
- Você pode bloquear no 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 periodicamente o cancelamento de registro com false para wait. Quando ele finalmente retornar true, todos os seus retornos de chamada estarão concluídos e você poderá excluir o estado.
- Se uma chamada de cancelamento de registro não invocar o retorno de chamada, você poderá simplesmente passar false para wait e ignorar o valor retornado.
