Microsoft 信息保护 SDK - MipContext 对象概念

MipContext

MipContext 是 SDK 中的最高级别对象。 它负责管理作为应用程序或服务的一部分创建的所有配置文件的状态。 此外,它会在 MipContext 对象被销毁后处理 MIP SDK 资源的释放。

重要

每个进程 MipContext 仅允许一个。 创建多个可能导致意外行为。 MipContext 应在应用开始时创建 ,并且创建在应用程序生存期中使用的同一 MipContext。

创建 对象 mip::MipContext 后, MipContext 该对象可用于创建 mip::FileProfile 、 或 mip::PolicyProfilemip::ProtectionProfile 对象。

创建 MipConfiguration

mip::MipConfiguration类允许应用程序为 MIP SDK 设置各种应用程序范围的配置设置。 这些设置包括:

  • 应用程序信息:名称、应用程序 ID、版本
  • 存储日志和缓存的目录
  • 日志记录级别
  • 脱机模式
  • 功能航班设置
  • 委托,包括日志记录、存储、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 对象后,它可用于创建 、 或 FileProfilePolicyProfile 对象, ProtectionProfile 具体取决于应用程序使用的 SDK。

关闭

正确销毁所有 MIP SDK 对象需要关闭 MIPContext。 这可以通过调用 Shutdown 函数实现 。 销毁 MipContext 对象时,析构 MipContext.Shutdown()MipContext 函数也将调用 。

mip::MipContext::CreateWithCustomFeatureSettings()

注意

MIP SDK 1.10 和 on 中已弃用此 API。 请更新为 使用 MipConfigurationmip::MipContext::Create() 和 。

创建一个新的 MipContext 实例,以在启用自定义功能设置时初始化配置文件时使用。

  • mip::ApplicationInfo
  • MIP 存储缓存的路径。
  • mip::LogLevel
  • (可选) mip::LoggerDelegate
  • (可选) mip::TelemetryConfiguration
  • mip::FlightingFeature

下一步