SDK da Proteção de Informações da Microsoft - Conceitos de objeto MipContext

  • Artigo

MipContext

MipContext é o objeto de nível mais alto no SDK. Ele é responsável por gerenciar o estado em todos os perfis que podem ser criados como parte de um aplicativo ou serviço. Além disso, ele lida com a liberação de recursos do MIP SDK depois que o objeto MipContext foi destruído.

Importante

Só é permitido um único MipContext por processo. Criar mais de um pode resultar em um comportamento inesperado. MipContext deve ser criado no início do aplicativo e o mesmo MipContext usado durante o tempo de vida do aplicativo.

Uma vez que um objeto de mip::MipContext tenha sido criado, o MipContext objeto pode ser usado para criar mip::FileProfile, mip::PolicyProfile, ou mip::ProtectionProfile objetos.

Criando MipConfiguration

A mip::MipConfiguration classe permite que o aplicativo defina várias definições de configuração em todo o aplicativo para o MIP SDK. Estas definições incluem:

  • Informações do aplicativo: nome, ID do aplicativo, versão
  • Diretório de armazenamento para logs e cache
  • Nível de registo
  • Modo offline
  • Configurações de vôo de recursos
  • Delegados, incluindo registro, armazenamento, HTTP, análise JSON e análise XML.
  • Configuração de diagnóstico
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);

Uma vez MipConfiguration inicializado, ele pode ser usado para criar o MipContext objeto.

Criando MipContext

A MipContext::Create() função é usada, tomando o objeto fornecido MipConfiguration , para criar o MipContext.

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

MipContext = mipContext = MIP.CreateMipContext(mipConfiguration);

Depois que o MipContext objeto é criado, ele pode ser usado para criar FileProfile, , ou objetos, PolicyProfileProtectionProfile dependendo de qual SDK seu aplicativo está usando.

Desligamento

A destruição adequada de todos os objetos MIP SDK requer o desligamento do MIPContext. Isso pode ser conseguido chamando a função Shutdown . O MipContext destruidor também chamará MipContext.Shutdown() quando o MipContext objeto for destruído.

mip::MipContext::CreateWithCustomFeatureSettings()

Nota

Esta API foi preterida no MIP SDK 1.10 e em diante. Por favor, atualize para usar MipConfiguration e mip::MipContext::Create().

Cria uma nova instância MipContext para ser usada ao inicializar perfis, com configurações de recursos personalizados habilitadas.

  • mip::ApplicationInfo
  • Um caminho para o cache de armazenamento MIP.
  • mip::LogLevel
  • (Opcional) mip::LoggerDelegate
  • (Opcional) mip::TelemetryConfiguration
  • mip::FlightingFeature

Passos Seguintes