Microsoft Information Protection SDK - concepts d’observateur

Le SDK MIP est presque entièrement asynchrone. Par exemple, le Kit de développement logiciel (SDK) effectue toutes les opérations qui entraînent des E/S réseau ou de fichier de manière asynchrone. Pour gérer les notifications d’événements pour ces événements asynchrones, le Kit de développement logiciel (SDK) utilise le modèle d’observateur.

Vue d’ensemble de l’implémentation

Lorsque vous construisez un objet qui effectue une opération asynchrone, implémentez une Observer classe. Les observateurs reçoivent les événements de notification liés aux différentes opérations asynchrones dans le Kit de développement logiciel (SDK) MIP et fournissent le résultat à l’appelant.

Vous pouvez remplacer les fonctions virtuelles dans chaque Observer classe pour le modèle asynchrone préféré. Le Kit de développement logiciel (SDK) implémente le modèle d’observateur de notification d’événement à l’aide std::promise et std::future.

Chaque observateur spécifique à une classe contient un ensemble de fonctions de réussite et d’erreur/échec pour le résultat d’une opération asynchrone. Les fonctions de réussite retournent l’objet associé à l’opération. Les fonctions d’échec/erreur retournent une exception qui contient des détails sur la raison pour laquelle l’opération a échoué.

Par exemple, FileProfile prend en charge les deux opérations suivantes :

  • Il peut ajouter un nouveau moteur au profil en utilisant FileProfile::AddEngineAsync.
  • Il est possible de décharger un moteur du profil en utilisant FileProfile::UnloadEngineAsync.

Étant donné que le SDK implémente deux Observer fonctions par opération asynchrone, vous pouvez supposer que quatreObserver méthodes sont associées à FileProfile:

  • FileProfileObserver::OnAddEngineSuccess()
  • FileProfileObserver::OnAddEngineError()
  • FileProfileObserver::OnUnloadEngineSuccess
  • FileProfileObserver::OnUnloadEngineError()

Classes d’observateur du SDK MIP

Le kit de développement logiciel (SDK) File MIP contient deux observateurs :

  • mip::FileProfile::Observer
  • mip::FileHandler::Observer

Le SDK de stratégie MIP a un observateur :

  • mip::Profile::Observer

Le SDK Protection MIP a trois observateurs :

  • mip::ProtectionProfile::Observer
  • mip::ProtectionEngine::Observer
  • mip::ProtectionHandler::Observer

Étapes suivantes

Découvrez comment les différents kits SDK implémentent et utilisent des observateurs :

  • Last updated on