Freigeben über


Microsoft Information Protection SDK – MipContext-Objektkonzepte

MipContext

MipContext ist das Objekt der höchsten Ebene im SDK. Er ist für die Verwaltung des Zustands in allen Profilen verantwortlich, die als Teil einer Anwendung oder eines Diensts erstellt werden können. Darüber hinaus behandelt es das Freigeben von MIP SDK-Ressourcen, sobald das MipContext-Objekt zerstört wurde.

Wichtig

Pro Prozess ist nur ein einzelner MipContext Vorgang zulässig. Das Erstellen mehrerer Dateien 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 ein Objekt mip::MipContext erstellt wurde, kann das MipContext Objekt verwendet werden, um mip::FileProfile, mip::PolicyProfile oder mip::ProtectionProfile Objekte zu 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);

Sobald MipConfiguration initialisiert ist, kann es verwendet werden, um das MipContext Objekt zu erstellen.

Erstellen von MipContext

Die MipContext::Create()-Funktion wird verwendet, um mit dem bereitgestellten MipConfiguration-Objekt das MipContext zu erstellen.

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

Nachdem 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.

Wird heruntergefahren...

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 on 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