Microsoft Information Protection SDK — pojęcia dotyczące obiektów MipContext

  • Artykuł

MipContext

MipContext jest obiektem najwyższego poziomu w zestawie SDK. Jest on odpowiedzialny za zarządzanie stanem we wszystkich profilach, które mogą zostać utworzone w ramach aplikacji lub usługi. Ponadto obsługuje zwalnianie zasobów zestawu MIP SDK po zniszczeniu obiektu MipContext.

Ważne

Dozwolone jest tylko jedno MipContext na proces. Utworzenie więcej niż jednego może spowodować nieoczekiwane zachowanie. MipContext powinna zostać utworzona na początku aplikacji, a ten sam tekst MipContext używany przez okres istnienia aplikacji.

Po utworzeniu mip::MipContextMipContext obiektu obiekt może służyć do tworzenia mip::FileProfileobiektów , mip::PolicyProfilelub mip::ProtectionProfile .

Tworzenie konfiguracji programu MipConfiguration

Klasa mip::MipConfiguration umożliwia aplikacji ustawianie różnych ustawień konfiguracji dla zestawu MIP SDK dla całej aplikacji. Do tych ustawień należą:

  • Informacje o aplikacji: nazwa, identyfikator aplikacji, wersja
  • Katalog magazynu dla dzienników i pamięci podręcznej
  • Poziom rejestrowania
  • Tryb offline
  • Ustawienia pakietu testowego funkcji
  • Delegaci, w tym rejestrowanie, magazyn, protokół HTTP, analizowanie kodu JSON i analizowanie kodu XML.
  • Konfiguracja diagnostyczna
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);

Po MipConfiguration zainicjowaniu można go użyć do utworzenia MipContext obiektu.

Tworzenie obiektu MipContext

Funkcja MipContext::Create() jest używana, przyjmując podany MipConfiguration obiekt, w celu utworzenia obiektu MipContext.

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

MipContext = mipContext = MIP.CreateMipContext(mipConfiguration);

Po utworzeniu MipContext obiektu można go użyć do utworzenia FileProfileobiektów , PolicyProfilelub ProtectionProfile , w zależności od zestawu SDK używanego przez aplikację.

Zamykanie

Prawidłowe niszczenie wszystkich obiektów zestawu MIP SDK wymaga zamknięcia protokołu MIPContext. Można to osiągnąć, wywołując funkcję Shutdown . Destruktor MipContext wywoła również MipContext.Shutdown() , gdy MipContext obiekt zostanie zniszczony.

mip::MipContext::CreateWithCustomFeatureSettings()

Uwaga

Ten interfejs API jest przestarzały w zestawie MIP SDK 1.10 i włączonym. Zaktualizuj program do używania i MipConfigurationmip::MipContext::Create().

Tworzy nowe wystąpienie MipContext do użycia podczas inicjowania profilów z włączonymi niestandardowymi ustawieniami funkcji.

  • mip::ApplicationInfo
  • Ścieżka pamięci podręcznej magazynu MIP.
  • mip::LogLevel
  • (Opcjonalnie) mip::LoggerDelegate
  • (Opcjonalnie) mip::TelemetryConfiguration
  • mip::FlightingFeature

Następne kroki