Microsoft Information Protection SDK - Concepten van MipContext-objecten

  • Artikel

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 gemaakt bij het starten van de app en dezelfde MipContext die wordt gebruikt voor de levensduur van de toepassing.

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

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 meer:

  • Toepassingsgegevens: naam, toepassings-id, versie
  • Opslagmap voor logboeken en cache
  • Niveau van logboekregistratie
  • Offlinemodus
  • Instellingen voor flighting van functies
  • 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 het object is geïnitialiseerd, kan het worden gebruikt om het MipContext object te maken.

MipContext maken

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

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 objecten te maken FileProfile, PolicyProfileof ProtectionProfile objecten, afhankelijk van welke SDK 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()

Notitie

Deze API is afgeschaft in MIP SDK 1.10 en aan. Werk bij naar het gebruik 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