Función SubscribeActivityCoordinatorPolicy (activitycoordinator.h)

Crea una suscripción que entrega notificaciones de coordinación a la devolución de llamada proporcionada en función de la configuración de la directiva. Tras la notificación, la devolución de llamada proporcionada se ejecuta con el contexto proporcionado. Una notificación con el estado actual se entregará inmediatamente en un subproceso independiente y se puede entregar antes de que se devuelva esta llamada. Los cambios realizados en la directiva después de suscribirse no afectan a la suscripción. Se puede usar una sola directiva para crear muchas suscripciones con configuraciones de directiva únicas. Las notificaciones se serializan.

Syntax

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

Parámetros

policy

Proporciona un identificador para la directiva de destino.

callback

Proporciona la devolución de llamada que se va a ejecutar para todas las notificaciones de coordinación de esta suscripción.

callbackContext

Proporciona el contexto que se va a pasar a la rutina de devolución de llamada.

subscription

Proporciona un puntero a un identificador de ACTIVITY_COORDINATOR_SUBSCRIPTION que recibe el identificador de suscripción creado.

Valor devuelto

Devuelve un VALOR HRESULT.

Observaciones

Nota No realice la actividad en esta devolución de llamada, ya que bloqueará la entrega de futuras notificaciones de directiva para esta suscripción. Esta devolución de llamada debe usarse para coordinar el inicio y la detención de la actividad en respuesta a las notificaciones RUN/STOP de la API.

Nota No bloquee esta devolución de llamada durante largos períodos de tiempo, ya que bloqueará la suscripciónActivityCoordinatorPolicy y puede contribuir al agotamiento del grupo de subprocesos.

Nota Se producirá un error en las llamadas a UnsubscribeActivityCoordinatorPolicy desde esta devolución de llamada. La cancelación de la suscripción debe producirse fuera de la devolución de llamada.

Requisitos

Consulte también

UnsubscribeActivityCoordinatorPolicy

ACTIVITY_COORDINATOR_CALLBACK

ACTIVITY_COORDINATOR_NOTIFICATION