다음을 통해 공유

Microsoft Information Protection SDK - 정책 SDK 관찰자

  • 아티클

정책 SDK에는 하나의 관찰자 클래스가 포함되어 있습니다. 관찰자 멤버는 가상이며 비동기 작업에 대한 콜백을 처리하도록 재정의되어야 합니다.

비동기 작업이 완료되면 OnXxx() 결과에 해당하는 멤버 함수가 호출됩니다. 예는 OnLoadSuccess(), OnLoadFailure()및 OnAddEngineSuccess() 에 대한 것입니다 mip::Profile::Observer.

아래 예제에서는 SDK 샘플에서도 사용되며 원하는 콜백 동작을 구현하도록 확장할 수 있는 promise/future 패턴을 보여 줍니다.

프로필 관찰자 구현

다음 예제에서는 .에서 mip::Profile::Observer파생된 클래스 ProfileObserver 를 만들었습니다. 멤버 함수는 샘플 전체에서 사용되는 미래/약속 패턴을 사용하도록 재정의되었습니다.

참고: 아래 샘플은 부분적으로만 구현되며 관련 관찰자에 대한 재정의를 mip::ProfileEngine 포함하지 않습니다.

profile_observer.h

헤더에서 파생된 다음 각 멤버 함수를 재정의하여 mip::Profile::Observer정의ProfileObserver합니다.

class ProfileObserver final : public mip::Profile::Observer {
public:
ProfileObserver() { }
  void OnLoadSuccess(const std::shared_ptr<mip::Profile>& profile, const std::shared_ptr<void>& context) override;
  void OnLoadFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) override;
  //TODO: Implement remaining members
};

profile_observer.cpp

구현 자체에서 각 관찰자 멤버 함수에 대해 수행할 작업을 정의합니다.

각 멤버는 두 개의 매개 변수를 허용합니다. 첫 번째는 함수에서 처리하는 클래스에 대한 공유 포인터입니다. ProfileObserver::OnLoadSuccess 은 (을 mip::Profile) 수신할 것으로 예상됩니다. ProfileObserver::OnAddEngineSuccess 를 예상할 수 mip::ProfileEngine있습니다.

두 번째는 컨텍스트에 대한 공유 포인터입니다. 구현에서 컨텍스트는 로 전달되는 shared_ptr<void>에 대한 참조std::promise입니다. 함수의 첫 번째 줄은 이를 캐스팅한 std::promise다음, 호출 promise된 개체에 저장합니다.

마지막으로 개체를 설정하고 promise->set_value() 전달하여 미래를 준비합니다 mip::Profile .

#include "profile_observer.h"
#include <future>

//Called when Profile is successfully loaded
void ProfileObserver::OnLoadSuccess(const std::shared_ptr<mip::Profile>& profile, const std::shared_ptr<void>& context) {
  //cast context to promise
  auto promise = std::static_pointer_cast<std::promise<std::shared_ptr<mip::Profile>>>(context);
  //set promise value to profile
  promise->set_value(profile);
}

//Called when Profile fails to load
void ProfileObserver::OnLoadFailure(const std::exception_ptr& error, const std::shared_ptr<void>& context) {
  auto promise = std::static_pointer_cast<std::promise<std::shared_ptr<mip::Profile>>>(context);
  promise->set_exception(error);
}

//TODO: Implement remaining observer members

비동기 작업을 수행할 때 관찰자 구현은 설정 생성자 또는 비동기 함수 자체에 전달됩니다.