Dela via

Microsoft Information Protection SDK – begrepp för MipContext-objekt

  • Artikel

MipContext

MipContext är det högsta nivåobjektet i SDK:et. Den ansvarar för att hantera tillstånd för alla profiler som kan skapas som en del av ett program eller en tjänst. Dessutom hanterar den frigörande av MIP SDK-resurser när MipContext-objektet har förstörts.

Viktigt!

Endast en enskild MipContext process tillåts. Om du skapar fler än en kan det leda till oväntat beteende. MipContext ska skapas vid appstart och samma MipContext som används för programmets livslängd.

När ett objekt i mip::MipContext har skapats MipContext kan objektet användas för att skapa mip::FileProfile, mip::PolicyProfileeller mip::ProtectionProfile objekt.

Skapa MipConfiguration

Med mip::MipConfiguration klassen kan programmet ange olika konfigurationsinställningar för hela programmet för MIP SDK. Några av dessa inställningar är:

  • Programinformation: Namn, Program-ID, version
  • Lagringskatalog för loggar och cacheminnen
  • Loggningsnivå
  • Offlineläge
  • Inställningar för funktionsflygning
  • Ombud, inklusive loggning, lagring, HTTP, JSON-parsning och XML-parsning.
  • Diagnostikkonfiguration
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);

När MipConfiguration har initierats kan det användas för att skapa MipContext objektet.

Skapa MipContext

Funktionen MipContext::Create() används, med det angivna MipConfiguration objektet, för att skapa MipContext.

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

MipContext = mipContext = MIP.CreateMipContext(mipConfiguration);

När objektet MipContext har skapats kan det användas för att skapa FileProfile, PolicyProfileeller ProtectionProfile objekt, beroende på vilken SDK som programmet använder.

Stänga

För att alla MIP SDK-objekt ska förstöras korrekt måste MIPContext stängas av. Detta kan uppnås genom att anropa funktionen Avstängning . Destructor MipContext anropar MipContext.Shutdown() också när objektet MipContext förstörs.

mip::MipContext::CreateWithCustomFeatureSettings()

Kommentar

Det här API:et är inaktuellt i MIP SDK 1.10 och på. Uppdatera till att använda MipConfiguration och mip::MipContext::Create().

Skapar en ny MipContext-instans som ska användas när profiler initieras, med anpassade funktionsinställningar aktiverade.

  • mip::ApplicationInfo
  • En sökväg för MIP-lagringscachen.
  • mip::LogLevel
  • (Valfritt) mip::LoggerDelegate
  • (Valfritt) mip::TelemetryConfiguration
  • mip::FlightingFeature

Nästa steg