通过

SubscribeActivityCoordinatorPolicy 函数 (activitycoordinator.h)

  • 项目

创建一个订阅，该订阅根据策略的配置将协调通知传递到提供的回调。 收到通知后，将提供的回调使用提供的上下文执行。 具有当前状态的通知将立即在单独的线程上传递，并且可以在此调用返回之前传递。 订阅后对策略所做的更改不会影响订阅。 单个策略可用于创建具有唯一策略配置的多个订阅。 通知已序列化。

语法

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

参数

policy

为目标策略提供句柄。

callback

提供要为此订阅中的所有协调通知执行的回调。

callbackContext

提供要传递给回调例程的上下文。

subscription

提供指向接收所创建订阅句柄 的ACTIVITY_COORDINATOR_SUBSCRIPTION 句柄的指针。

返回值

返回 HRESULT。

注解

注意 请勿在此回调中执行活动，因为它将阻止此订阅的未来策略通知的传递。 应使用此回调来协调活动的启动和停止，以响应来自 API 的 RUN/STOP 通知。

注意 请勿长时间阻止此回调，因为它会阻止 UnsubscribeActivityCoordinatorPolicy ，并可能导致线程池耗尽。

注意 从此回调调用 UnsubscribeActivityCoordinatorPolicy 将失败。 取消订阅必须在回调外部发生。

要求

要求 值
Header activitycoordinator.h

另请参阅

UnsubscribeActivityCoordinatorPolicy

ACTIVITY_COORDINATOR_CALLBACK

ACTIVITY_COORDINATOR_NOTIFICATION