Partilhar via


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

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 do que um pode resultar em comportamento inesperado. MipContext deve ser criado no início da aplicação, e o mesmo MipContext usado durante a duração da aplicação.

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.

Criar Configuração Mip

A mip::MipConfiguration classe permite que o aplicativo defina várias definições de configuração em todo o aplicativo para o MIP SDK. Essas configuraçõ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 ativação de funcionalidades
  • 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, PolicyProfile, ou ProtectionProfile objetos, 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 destrutor também chamará o MipContext.Shutdown() quando o objeto MipContext for destruído.

mip::MipContext::CreateWithCustomFeatureSettings()

Observação

Esta API foi preterida no MIP SDK 1.10 e seguintes. 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

Próximas Etapas