Compartilhar via

SDK da Proteção de Informações da Microsoft - conceitos do 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 SDK da PIM depois que o objeto MipContext foi destruído.

Importante

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

Depois que um objeto de mip::MipContext foi criado, o objeto MipContext pode ser usado para criar os objetos mip::FileProfile, mip::PolicyProfile ou mip::ProtectionProfile.

Criação de MipConfiguration

A classe mip::MipConfiguration permite que o aplicativo defina várias configurações em todo o aplicativo para o SDK da PIM. 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 log
  • Modo offline
  • Configurações de versão piloto de recursos
  • Delegados, incluindo registro em log, 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 que MipConfiguration seja inicializado, ele pode ser usado para criar o objeto MipContext.

Criação de MipContext

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

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

MipContext = mipContext = MIP.CreateMipContext(mipConfiguration);

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

Desligando

A destruição correta de todos os objetos do SDK da PIM exige o desligamento do MIPContext. Isso pode ser feito chamando a função Desligamento. O destruidor MipContext também chamará MipContext.Shutdown() quando o objeto MipContext for destruído.

mip::MipContext::CreateWithCustomFeatureSettings()

Observação

Essa API foi preterida no SDK 1.10 e posterior da PIM. Atualize para usar MipConfiguration e mip::MipContext::Create().

Cria uma nova instância MipContext a ser usada ao inicializar perfis, com configurações de recurso personalizadas habilitadas.

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

Próximas etapas