Пакет SDK Microsoft Information Protection — основные понятия объектов MipContext

  • Статья

MipContext

MipContext — это объект самого высокого уровня в пакете SDK. Он отвечает за управление состоянием во всех профилях, которые могут быть созданы как часть приложения или службы. Кроме того, он обрабатывает освобождение ресурсов пакета SDK MIP после уничтожения объекта MipContext.

Важно!

Допускается только один процесс MipContext . Создание нескольких из них может привести к неожиданному поведению. MipContext необходимо создать в начале приложения и тот же MipContext, который использовался в течение всего времени существования приложения.

После создания MipContext объекта mip::MipContext объект можно использовать для создания mip::FileProfileобъектов mip::PolicyProfileили mip::ProtectionProfile объектов.

Создание MipConfiguration

Класс mip::MipConfiguration позволяет приложению задавать различные параметры конфигурации на уровне приложения для пакета SDK для MIP. К этим параметрам относятся:

  • Сведения о приложении: имя, идентификатор приложения, версия
  • каталог служба хранилища для журналов и кэша
  • Уровень ведения журнала
  • Автономный режим
  • Параметры тестовой функции
  • Делегаты, включая ведение журнала, хранилище, 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 После создания объекта его можно использовать для создания FileProfileили PolicyProfileProtectionProfile объектов в зависимости от того, какой пакет SDK использует приложение.

Завершает работу

Для правильного уничтожения всех объектов пакета SDK MIP требуется завершение работы MIPContext. Это можно сделать, вызвав функцию завершения работы . Деструктор MipContext также вызывается MipContext.Shutdown() при MipContext уничтожении объекта.

mip::MipContext::CreateWithCustomFeatureSettings()

Примечание.

Этот API устарел в пакете SDK для MIP 1.10 и включен. Обновите использование MipConfiguration и mip::MipContext::Create().

Создает новый экземпляр MipContext для использования при инициализации профилей с включенными настраиваемыми параметрами компонентов.

  • mip::ApplicationInfo
  • Путь к кэшу хранилища MIP.
  • mip::LogLevel
  • (Необязательно) mip::LoggerDelegate
  • (Необязательно) mip::TelemetryConfiguration
  • mip::FlightingFeature

Дальнейшие действия