Função SubscribeActivityCoordinatorPolicy (activitycoordinator.h)

  • Artigo

Cria uma assinatura que fornece notificações de coordenação para o retorno de chamada fornecido com base na configuração da política. Após a notificação, o retorno de chamada fornecido é executado com o contexto fornecido. Uma notificação com o estado atual será entregue imediatamente em um thread separado e poderá ser entregue antes que essa chamada retorne. As alterações feitas na política após a assinatura não afetam a assinatura. Uma única política pode ser usada para criar muitas assinaturas com configurações de política exclusivas. As notificações são serializadas.

Sintaxe

HRESULT SubscribeActivityCoordinatorPolicy(
  ACTIVITY_COORDINATOR_POLICY       policy,
  ACTIVITY_COORDINATOR_CALLBACK     callback,
  void                              *callbackContext,
  ACTIVITY_COORDINATOR_SUBSCRIPTION *subscription
);

Parâmetros

policy

Fornece um identificador para a política de destino.

callback

Fornece o retorno de chamada a ser executado para todas as notificações de coordenação dessa assinatura.

callbackContext

Fornece o contexto a ser passado para a rotina de retorno de chamada.

subscription

Fornece um ponteiro para um identificador de ACTIVITY_COORDINATOR_SUBSCRIPTION que recebe o identificador de assinatura criado.

Retornar valor

Retorna um HRESULT.

Comentários

Nota Não execute sua atividade neste retorno de chamada, pois bloqueará a entrega de futuras notificações de política para essa assinatura. Esse retorno de chamada deve ser usado para coordenar o início e a interrupção de sua atividade em resposta às notificações RUN/STOP da API.

Nota Não bloqueie esse retorno de chamada por longos períodos de tempo, pois bloqueará UnsubscribeActivityCoordinatorPolicy e poderá contribuir para o esgotamento do pool de threads.

Nota As chamadas para UnsubscribeActivityCoordinatorPolicy desse retorno de chamada falharão. A insubscrição deve ocorrer fora do retorno de chamada.

Requisitos

Requisito Valor
Cabeçalho activitycoordinator.h

Confira também

CancelarsubscribeActivityCoordinatorPolicy

ACTIVITY_COORDINATOR_CALLBACK

ACTIVITY_COORDINATOR_NOTIFICATION