Microsoft Information Protection SDK – Konzepte der MipContext-Objekte

  • Artikel

MipContext

MipContext ist das Objekt der höchsten Ebene im SDK. Es ist verantwortlich für das Verwalten des Zustands in allen Profilen, die möglicherweise als Teil einer Anwendung oder eines Diensts erstellt werden. Darüber hinaus bearbeitet es die Freigabe von MIP SDK-Ressourcen, sobald das MipContext-Objekt zerstört wurde.

Wichtig

Es ist nur ein Einzelner MipContext pro Prozess zulässig. Das Erstellen von mehr als einem kann zu unerwartetem Verhalten führen. MipContext sollte zum Start der App erstellt werden, und derselbe MipContext sollte für die Lebensdauer der Anwendung verwendet werden.

Sobald ein Objekt von mip::MipContext erstellt wurde, kann das MipContext-Objekt verwendet werden, um mip::FileProfile-, mip::PolicyProfile- oder mip::ProtectionProfile-Objekte zu erstellen.

Erstellen der MipConfiguration

Die mip::MipConfiguration-Klasse ermöglicht es der Anwendung, verschiedene anwendungsweite Konfigurationseinstellungen für MIP SDK festzulegen. Diese Einstellungen umfassen Folgendes:

  • 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);

Sobald die MipConfiguration initialisiert ist, kann sie verwendet werden, um das MipContext-Objekt zu erstellen.

Erstellen von MipContext

Die MipContext::Create() Funktion wird genutzt, wobei das bereitgestellte MipConfiguration-Objekt verwendet wird, um den MipContext zu erstellen.

std::shared_ptr<mip::MipContext> mMipContext = mip::MipContext::Create(mipConfiguration);

MipContext = mipContext = MIP.CreateMipContext(mipConfiguration);

Sobald das MipContext-Objekt erstellt wurde, kann es verwendet werden, um FileProfile-, PolicyProfile- oder ProtectionProfile-Objekte zu erstellen, abhängig davon, welches SDK Ihre Anwendung verwendet.

Herunterfahren

Das ordnungsgemäße Zerstören aller MIP SDK-Objekte erfordert das Herunterfahren von MIPContext. Dies kann durch den Aufruf der Funktion Herunterfahren erreicht werden. Der MipContext-Destruktor ruft auch MipContext.Shutdown() auf, wenn das MipContext-Objekt zerstört wird.

mip::MipContext::CreateWithCustomFeatureSettings()

Hinweis

Diese API ist in MIP SDK 1.10 und höher veraltet. Bitte aktualisieren Sie auf die Verwendung von MipConfiguration und mip::MipContext::Create().

Erstellt eine neue MipContext-Instanz, die beim Initialisieren von Profilen verwendet werden soll, wobei benutzerdefinierte Featureeinstellungen aktiviert sind.

  • mip::ApplicationInfo
  • Ein Pfad für den MIP-Speichercache.
  • mip::LogLevel
  • (Optional) mip::LoggerDelegate
  • (Optional) mip::TelemetryConfiguration
  • mip::FlightingFeature

Nächste Schritte