Função SubscribeActivityCoordinatorPolicy (activitycoordinator.h)
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 |