Fonction SubscribeActivityCoordinatorPolicy (activitycoordinator.h)

Crée un abonnement qui fournit des notifications de coordination au rappel fourni en fonction de la configuration de la stratégie. Lors de la notification, le rappel fourni est exécuté avec le contexte fourni. Une notification avec l’état actuel est remise immédiatement sur un thread distinct et peut être remise avant le retour de cet appel. Les modifications apportées à la stratégie après l’abonnement n’affectent pas l’abonnement. Une stratégie unique peut être utilisée pour créer de nombreux abonnements avec des configurations de stratégie uniques. Les notifications sont sérialisées.

Syntaxe

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

Paramètres

policy

Fournit un handle à la stratégie cible.

callback

Fournit le rappel à exécuter pour toutes les notifications de coordination de cet abonnement.

callbackContext

Fournit le contexte à passer à la routine de rappel.

subscription

Fournit un pointeur vers un handle ACTIVITY_COORDINATOR_SUBSCRIPTION qui reçoit le handle d’abonnement créé.

Valeur retournée

Retourne un HRESULT.

Remarques

Note N’effectuez pas votre activité dans ce rappel, car cela bloquera la remise des futures notifications de stratégie pour cet abonnement. Ce rappel doit être utilisé pour coordonner le démarrage et l’arrêt de votre activité en réponse aux notifications RUN/STOP de l’API.

Note Ne bloquez pas ce rappel pendant de longues périodes, car il bloquera UnsubscribeActivityCoordinatorPolicy et peut contribuer à l’épuisement du pool de threads.

Note Les appels à UnsubscribeActivityCoordinatorPolicy à partir de ce rappel échouent. La désinscripation doit se produire en dehors du rappel.

Configuration requise

Condition requise	Valeur
En-tête	activitycoordinator.h

Voir aussi

UnsubscribeActivityCoordinatorPolicy

ACTIVITY_COORDINATOR_CALLBACK

ACTIVITY_COORDINATOR_NOTIFICATION