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 에 대한 호출이 실패합니다. 구독 취소는 콜백 외부에서 발생해야 합니다.

요구 사항

요구 사항	값
헤더	activitycoordinator.h

추가 정보

UnsubscribeActivityCoordinatorPolicy

ACTIVITY_COORDINATOR_CALLBACK

ACTIVITY_COORDINATOR_NOTIFICATION