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