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.
Sintaxis
HRESULT SubscribeActivityCoordinatorPolicy(
ACTIVITY_COORDINATOR_POLICY policy,
ACTIVITY_COORDINATOR_CALLBACK callback,
void *callbackContext,
ACTIVITY_COORDINATOR_SUBSCRIPTION *subscription
);
Parámetros
policy
Proporciona un identificador a 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.
Comentarios
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 se debe usar 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á UnsubscribeActivityCoordinatorPolicy y puede contribuir al agotamiento del grupo de subprocesos.
Nota Se producirá un error en las llamadas a UnsubscribeActivityCoordinatorPolicy de esta devolución de llamada. La anulación de la suscripción debe producirse fuera de la devolución de llamada.
Requisitos
| Requisito | Valor |
|---|---|
| Header | activitycoordinator.h |