共用方式為


Microsoft資訊保護 SDK - MipContext 物件概念

MipContext

MipContext 是 SDK 中最高層級的物件。 它負責管理在應用程式或服務中可能建立的所有設定檔的狀態。 此外,它會在 MipContext 物件銷毀後處理釋放 MIP SDK 資源。

這很重要

每個進程只能有一個 MipContext 。 建立多個可能會導致非預期的行為。 MipContext 應该在應用程式啟動時建立,並在整個應用程式生命週期中使用相同的 MipContext。

建立mip::MipContext物件後,可以使用MipContext物件來建立mip::FileProfilemip::PolicyProfilemip::ProtectionProfile物件。

建立 MipConfiguration

類別 mip::MipConfiguration 可讓應用程式設定 MIP SDK 的各種全應用程式組態設定。 這些設定包括:

  • 應用程式資訊:名稱、應用程式識別碼、版本
  • 記錄和快取的儲存目錄
  • 記錄層級
  • 離線模式
  • 功能分階段推出設定
  • 代理,包括記錄、儲存、HTTP、JSON 剖析和 XML 剖析。
  • 診斷組態
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);

初始化之後 MipConfiguration ,即可用來建立 MipContext 物件。

建立 MipContext

會使用 函 MipContext::Create() 式來取得提供的 MipConfiguration 物件,以建立 MipContext

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

MipContext建立物件之後,即可根據應用程式所使用的 SDK 來建立FileProfilePolicyProfileProtectionProfile 物件。

關閉

正確地銷毀所有 MIP SDK 物件需要關閉 MIPContext。 呼叫 Shutdown 函式即可達成此目的。 解MipContext物件時,MipContext解構函式也會呼叫MipContext.Shutdown()

mip::MipContext::CreateWithCustomFeatureSettings()

備註

此 API 在 MIP SDK 1.10 和更新版本中已被取代。 請更新為使用 MipConfigurationmip::MipContext::Create()

建立初始化配置檔時要使用的新 MipContext 實例,並啟用自定義功能設定。

  • mip::ApplicationInfo
  • MIP 記憶體快取的路徑。
  • mip::LogLevel
  • (選擇性) mip::LoggerDelegate
  • (選擇性) mip::TelemetryConfiguration
  • mip::FlightingFeature

後續步驟