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 |