Microsoft Information Protection SDK - MipContext オブジェクトの概念

  • [アーティクル]

MipContext

MipContext は、SDK の最上位オブジェクトです。 アプリケーションまたはサービスの一部として作成される可能性がある、すべてのプロファイル間の状態を管理するためのものです。 また、MipContext オブジェクトが破棄された際に、MIP SDK リソースの解放を行います。

重要

プロセスごとに 1 つの MipContext が許可されます。 複数作成すると、予期しない動作が発生する可能性があります。 MipContext はアプリの起動時に作成され、アプリケーションの有効期間中、同じ MipContext が使用されます。

mip::MipContext のオブジェクトが作成されたら、MipContext オブジェクトを使用して mip::FileProfile、mip::PolicyProfile、mip::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 を作成するには、指定された MipConfiguration オブジェクトを取る MipContext::Create() 関数を使用します。

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

MipContext = mipContext = MIP.CreateMipContext(mipConfiguration);

MipContext オブジェクトが作成されたら、それを使用して、アプリケーションが使用している SDK に応じて FileProfile、PolicyProfile、ProtectionProfile オブジェクトを作成できます。

Shutting Down

すべての MIP SDK オブジェクトを適切に破棄するには、MIPContext をシャットダウンする必要があります。 これは、Shutdown 関数を呼び出すことで実現できます。 MipContext オブジェクトが破棄されるときに、MipContext デストラクターは MipContext.Shutdown() も呼び出します。

mip::MipContext::CreateWithCustomFeatureSettings()

Note

この API は MIP SDK 1.10 以降では非推奨です。 MipConfiguration と mip::MipContext::Create() を使用するように更新してください。

カスタムの機能設定を有効にした状態で、プロファイルを初期化するときに使用される新しい MipContext インスタンスを作成します。

  • mip::ApplicationInfo
  • MIP ストレージ キャッシュのパス。
  • mip::LogLevel
  • (オプション) mip::LoggerDelegate
  • (オプション) mip::TelemetryConfiguration
  • mip::FlightingFeature

次のステップ