SDK de Microsoft Information Protection: Conceptos del objeto MipContext
MipContext
MipContext
es el objeto de nivel más alto del SDK. Es responsable de administrar el estado en todos los perfiles que se puedan crear como parte de una aplicación o servicio. Además, controla la liberación de recursos del SDK de MIP una vez que se ha destruido el objeto MipContext.
Importante
Solo se permite un solo MipContext
por proceso. La creación de más de un objeto puede dar lugar a un comportamiento inesperado. MipContext
debe crearse en el inicio de la aplicación, y debe usarse el mismo MipContext durante la vigencia de la aplicación.
Una vez creado un objeto de mip::MipContext
, se puede usar el objeto MipContext
para crear objetos mip::FileProfile
, mip::PolicyProfile
o mip::ProtectionProfile
.
Creación de MipConfiguration
La clase mip::MipConfiguration
permite a la aplicación establecer varias opciones de configuración para toda la aplicación en el SDK de MIP. Entre estas opciones se incluyen:
- Información de la aplicación: nombre, identificador de la aplicación, versión
- Directorio de almacenamiento para registros y caché
- Nivel de registro
- Modo sin conexión
- Configuración de distribuciones de paquetes piloto de características
- Delegados, incluidos el registro, el almacenamiento, HTTP, el análisis de JSON y el análisis xml.
- Configuración 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);
Una vez inicializado MipConfiguration
, se puede usar para crear el objeto MipContext
.
Creación de MipContext
La función MipContext::Create()
se usa, tomando el objeto MipConfiguration
proporcionado, para crear MipContext
.
std::shared_ptr<mip::MipContext> mMipContext = mip::MipContext::Create(mipConfiguration);
MipContext = mipContext = MIP.CreateMipContext(mipConfiguration);
Una vez creado el objeto MipContext
, se puede usar para crear objetos FileProfile
, PolicyProfile
o ProtectionProfile
, en función del SDK que use la aplicación.
Apagado
Para destruir todos los objetos del SDK de MIP, es necesario apagar MIPContext. Para ello, puede llamar a la función Shutdown. El destructor MipContext
también llamará a MipContext.Shutdown()
cuando se destruya el objeto MipContext
.
mip::MipContext::CreateWithCustomFeatureSettings()
Nota:
Esta API está en desuso a partir de MIP SDK 1.10. Empiece a usar MipConfiguration
y mip::MipContext::Create()
.
Esto crea una nueva instancia de MipContext que se usará al inicializar perfiles con la configuración de características personalizadas habilitada.
mip::ApplicationInfo
- Ruta de acceso para la memoria caché de almacenamiento de MIP.
mip::LogLevel
- (Opcional)
mip::LoggerDelegate
- (Opcional)
mip::TelemetryConfiguration
mip::FlightingFeature
Pasos siguientes
- A continuación, obtenga más información sobre los conceptos de autenticación y los observadores. MIP proporciona un modelo de autenticación extensible, mientras que los observadores se usan para proporcionar notificaciones de eventos asincrónicos. Ambos son fundamentales y se aplican a todos los conjuntos de API de MIP.
- Después, trabaje con los conceptos de perfil y motor para los SDK de archivos, directivas y protección.