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 que cet appel ne retourne. 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 elle bloque la remise des notifications de stratégie futures 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 des périodes prolongées, car il bloque UnsubscribeActivityCoordinatorPolicy et peut contribuer à l’épuisement du pool de threads.

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

Spécifications

Voir aussi

UnsubscribeActivityCoordinatorPolicy

ACTIVITY_COORDINATOR_CALLBACK

ACTIVITY_COORDINATOR_NOTIFICATION