Microsoft Information Protection SDK – MipContext-Objektkonzepte

MipContext

MipContext ist das Objekt der höchsten Ebene im SDK. Sie ist für die Verwaltung des Zustands für alle Profile verantwortlich, die als Teil einer Anwendung oder eines Diensts erstellt wurden. Es behandelt auch das Freigeben von MIP SDK-Ressourcen, nachdem das MipContext-Objekt zerstört wurde.

Wichtig

Pro Prozess ist nur ein einzelner MipContext Vorgang zulässig. Das Erstellen von mehr als einem kann zu unerwartetem Verhalten führen. MipContext sollte beim Start der App erstellt werden und während der gesamten Laufzeit der Anwendung derselbe MipContext verwendet werden.

Nachdem Sie ein mip::MipContext-Objekt erstellt haben, können Sie damit mip::PolicyProfile-, mip::FileProfile- oder mip::ProtectionProfile-Objekte erstellen.

Erstellen der MipConfiguration

Mit mip::MipConfiguration der Klasse kann die Anwendung verschiedene anwendungsweite Konfigurationseinstellungen für das MIP SDK festlegen. Zu diesen Einstellungen gehören folgende:

  • Anwendungsinformationen: Name, Anwendungs-ID, Version
  • Speicherverzeichnis für Protokolle und Cache
  • Protokolliergrad
  • Offlinemodus
  • Feature: Einstellungen zum Erstellen von Flights
  • Delegaten, einschließlich Protokollierung, Speicher, HTTP, JSON-Analyse und XML-Analyse.
  • Diagnosekonfiguration
std::shared_ptr<mip::MipConfiguration> mipConfiguration = std::make_shared<mip::MipConfiguration>(mAppInfo,
				"mip_data",
				mip::LogLevel::Trace,
				false);
MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false);

Nach der Initialisierung MipConfigurationkönnen Sie es verwenden, um das MipContext Objekt zu erstellen.

Erstellen von MipContext

Rufen Sie die Funktion MipContext::Create() mit dem bereitgestellten Objekt MipConfiguration auf, um MipContext zu erstellen.

std::shared_ptr<mip::MipContext> mMipContext = mip::MipContext::Create(mipConfiguration);
MipContext = mipContext = MIP.CreateMipContext(mipConfiguration);

Nachdem Sie das MipContext-Objekt erstellt haben, können Sie es verwenden, um je nachdem, welches SDK Ihre Anwendung verwendet, FileProfile-, PolicyProfile- oder ProtectionProfile-Objekte zu erstellen.

Herunterfahren

Das ordnungsgemäße Zerstören aller MIP SDK-Objekte erfordert das Herunterfahren von MipContext. Rufen Sie dazu die Funktion Shutdown auf. Der MipContext Destruktor ruft auch auf MipContext.Shutdown() , wenn das MipContext Objekt zerstört wird.

Nächste Schritte