Delen via


Microsoft Information Protection SDK - Concepten van MipContext-objecten

MipContext

MipContext is het hoogste niveauobject in de SDK. Het is verantwoordelijk voor het beheren van de status voor alle profielen die kunnen worden gemaakt als onderdeel van een toepassing of service. Daarnaast wordt het vrijgeven van MIP SDK-resources afgehandeld zodra het MipContext-object is vernietigd.

Belangrijk

Er is slechts één MipContext per proces toegestaan. Het maken van meer dan één kan leiden tot onverwacht gedrag. MipContext moet worden aangemaakt bij het starten van de app, en dezelfde MipContext dient gebruikt te worden voor de duur van de toepassing.

Zodra een object van mip::MipContext is gemaakt, kan het MipContext object worden gebruikt om mip::FileProfile, mip::PolicyProfile of mip::ProtectionProfile objecten te maken.

MipConfiguration maken

Met mip::MipConfiguration de klasse kan de toepassing verschillende configuratie-instellingen voor de hele toepassing instellen voor DE MIP SDK. Deze instellingen zijn onder andere:

  • Toepassingsgegevens: naam, toepassings-id, versie
  • Opslagmap voor logboeken en cache
  • Niveau van logboekregistratie
  • Offlinemodus
  • Instellingen voor functie-uitrol
  • Gemachtigden, waaronder logboekregistratie, opslag, HTTP, JSON-parsering en XML-parsering.
  • Diagnostische configuratie
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);

Zodra MipConfiguration is geïnitialiseerd, kan het worden gebruikt om het MipContext-object te maken.

MipContext maken

De MipContext::Create() functie wordt gebruikt, waarbij het opgegeven MipConfiguration object wordt genomen, om de MipContext te maken.

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

Zodra het MipContext object is gemaakt, kan het worden gebruikt om FileProfile, PolicyProfile of ProtectionProfile objecten te maken, afhankelijk van de SDK die uw toepassing gebruikt.

Afsluiten

Voor het correct vernietigen van alle MIP SDK-objecten is het afsluiten van MIPContext vereist. Dit kan worden bereikt door de functie Afsluiten aan te roepen. De MipContext destructor roept ook MipContext.Shutdown() aan wanneer het MipContext object wordt vernietigd.

mip::MipContext::CreateWithCustomFeatureSettings()

Opmerking

Deze API is verouderd verklaard in MIP SDK 1.10 en verder. Stap over op het gebruik van MipConfiguration en mip::MipContext::Create().

Hiermee maakt u een nieuw MipContext-exemplaar dat moet worden gebruikt bij het initialiseren van profielen, waarbij aangepaste functie-instellingen zijn ingeschakeld.

  • mip::ApplicationInfo
  • Een pad voor de MIP-opslagcache.
  • mip::LogLevel
  • (Optioneel) mip::LoggerDelegate
  • (Optioneel) mip::TelemetryConfiguration
  • mip::FlightingFeature

Volgende stappen