共用方式為

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

  • 發行項

MipCoNtext

MipContext 是 SDK 中最高層級的物件。 它負責管理所有可能建立為應用程式或服務一部分的設定檔的狀態。 此外，它會處理在 MipCoNtext 物件終結之後釋放 MIP SDK 資源。

重要

每個進程只能有一個 MipContext 。 建立多個可能會導致非預期的行為。 MipContext 應該在應用程式啟動時建立，以及用於應用程式存留期的相同 MipCoNtext。

建立 的 物件 mip::MipContext 之後， MipContext 就可以使用 物件來建立 mip::FileProfile 、 mip::PolicyProfile 或 mip::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 來建立 FileProfile 、 PolicyProfile 或 ProtectionProfile 物件。

關閉

正確終結所有 MIP SDK 物件需要關閉 MIPCoNtext。 呼叫 Shutdown 函式即可達成此目的 。 解 MipContext 構函式也會在終結物件時 MipContext 呼叫 MipContext.Shutdown() 。

mip::MipContext::CreateWithCustomFeatureSettings()

注意

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

建立初始化設定檔時要使用的新 MipCoNtext 實例，並啟用自訂功能設定。

  • mip::ApplicationInfo
  • MIP 儲存體快取的路徑。
  • mip::LogLevel
  • （選擇性） mip::LoggerDelegate
  • （選擇性） mip::TelemetryConfiguration
  • mip::FlightingFeature

後續步驟