Microsoft Information Protection SDK - Concetti relativi all'oggetto MipContext

  • Articolo

MipContext

MipContext è l'oggetto di livello più alto nell'SDK. È responsabile della gestione dello stato in tutti i profili che possono essere creati come parte di un'applicazione o di un servizio. Inoltre, gestisce il rilascio delle risorse di MIP SDK dopo che l'oggetto MipContext è stato eliminato definitivamente.

Importante

È consentito un solo processo MipContext per processo. La creazione di più di una può comportare un comportamento imprevisto. MipContext deve essere creato all'avvio dell'app e lo stesso MipContext usato per la durata dell'applicazione.

Dopo aver creato un oggetto di mip::MipContext , l'oggetto MipContext può essere usato per creare mip::FileProfileoggetti , o .mip::ProtectionProfilemip::PolicyProfile

Creazione di MipConfiguration

La mip::MipConfiguration classe consente all'applicazione di impostare varie impostazioni di configurazione a livello di applicazione per MIP SDK. Queste impostazioni includono:

  • Informazioni sull'applicazione: Nome, ID applicazione, versione
  • Archiviazione directory per i log e la cache
  • Livello di registrazione
  • Modalità offline
  • Impostazioni di anteprima delle funzionalità
  • Delegati, tra cui registrazione, archiviazione, HTTP, analisi JSON e analisi XML.
  • Configurazione diagnostica
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 volta MipConfiguration inizializzato, può essere usato per creare l'oggetto MipContext .

Creazione di MipContext

La MipContext::Create() funzione viene usata, prendendo l'oggetto fornito MipConfiguration , per creare l'oggetto MipContext.

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

MipContext = mipContext = MIP.CreateMipContext(mipConfiguration);

Dopo aver creato l'oggetto MipContext , può essere usato per creare FileProfileoggetti , PolicyProfileo ProtectionProfile a seconda dell'SDK usato dall'applicazione.

Arresto

L'eliminazione corretta di tutti gli oggetti SDK MIP richiede l'arresto di MIPContext. A tale scopo, è possibile chiamare la funzione Shutdown . Il MipContext distruttore chiamerà MipContext.Shutdown() anche quando l'oggetto MipContext viene eliminato definitivamente.

mip::MipContext::CreateWithCustomFeatureSettings()

Nota

Questa API è deprecata in MIP SDK 1.10 e versioni. Eseguire l'aggiornamento all'uso di MipConfiguration e mip::MipContext::Create().

Crea una nuova istanza di MipContext da usare durante l'inizializzazione dei profili, con impostazioni di funzionalità personalizzate abilitate.

  • mip::ApplicationInfo
  • Percorso della cache di archiviazione MIP.
  • mip::LogLevel
  • (Facoltativo) mip::LoggerDelegate
  • (Facoltativo) mip::TelemetryConfiguration
  • mip::FlightingFeature

Passaggi successivi