Zestaw SDK usługi Microsoft Information Protection — pojęcia dotyczące profilu zestawu SDK ochrony

W dwóch poniższych przykładach pokazano, jak utworzyć obiekt profileSettings przy użyciu magazynu lokalnego dla magazynu stanu, a także tylko w pamięci.

Ładowanie profilu

Teraz, gdy element ProtectionProfileObserverImpl jest zdefiniowany, użyjemy go do utworzenia wystąpienia mip::ProtectionProfileelementu . mip::ProtectionProfile Utworzenie obiektu wymaga elementu mip::ProtectionProfile::Settings.

ProtectionProfile::Settings Parameters

• std::shared_ptr<MipContext> mip::MipContext: obiekt, który został zainicjowany do przechowywania informacji o aplikacji, ścieżki stanu itp.
• mip::CacheStorageType: definiuje sposób przechowywania stanu: w pamięci, na dysku lub na dysku i zaszyfrowane.
• std::shared_ptr<mip::ConsentDelegate>: współużytkowany wskaźnik klasy mip::ConsentDelegate.
• std::shared_ptr<mip::ProtectionProfile::Observer> observer: wskaźnik udostępniony do implementacji profilu Observer (w PolicyProfilesystemach , ProtectionProfilei FileProfile).

W dwóch poniższych przykładach pokazano, jak utworzyć obiekt profileSettings przy użyciu magazynu lokalnego dla magazynu stanu, a także tylko w pamięci.

Przechowywanie stanu tylko w pamięci

mip::ApplicationInfo appInfo {clientId, "APP NAME", "1.2.3" };

std::shared_ptr<mip::MipConfiguration> mipConfiguration = std::make_shared<mip::MipConfiguration>(mAppInfo,
				                                                                                  "mip_data",
                                                                                        		  mip::LogLevel::Trace,
                                                                                                  false);

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

ProtectionProfile::Settings profileSettings(
    mMipContext,                                        // mipContext object
    mip::CacheStorageType::InMemory,                   // use in memory storage    
    std::make_shared<ConsentDelegateImpl>(),           // new consent delegate
    std::make_shared<ProtectionProfileObserverImpl>()); // new protection profile observer

Ustawienia profilu odczytu/zapisu ze ścieżki magazynu na dysku

mip::ApplicationInfo appInfo {clientId, "APP NAME", "1.2.3" };

std::shared_ptr<mip::MipConfiguration> mipConfiguration = std::make_shared<mip::MipConfiguration>(mAppInfo,
    		                                                                                       "mip_data",
                                                                                       			   mip::LogLevel::Trace,
                                                                                                   false);

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

ProtectionProfile::Settings profileSettings(
    mMipContext,                                         // mipContext object
    mip::CacheStorageType::OnDisk,                      // use on disk storage    
    std::make_shared<ConsentDelegateImpl>(),            // new consent delegate
    std::make_shared<ProtectionProfileObserverImpl>()); // new protection profile

Następnie użyj wzorca promise/future, aby załadować ProtectionProfileelement .

auto profilePromise = std::make_shared<std::promise<std::shared_ptr<ProtectionProfile>>>();
auto profileFuture = profilePromise->get_future();
ProtectionProfile::LoadAsync(profileSettings, profilePromise);

Jeśli załadowaliśmy profil i operacja zakończyła się pomyślnie, ProtectionProfileObserverImpl::OnLoadSuccesswywoływana jest nasza implementacja mip::ProtectionProfile::Observer::OnLoadSuccess . Wynikowy obiekt lub wskaźnik wyjątku, a także kontekst, są przekazywane jako parametry do funkcji. Kontekst jest wskaźnikiem utworzonym std::promise w celu obsługi operacji asynchronicznych. Funkcja po prostu ustawia wartość obietnicy na obiekt ProtectionProfile (kontekst). Gdy funkcja main używa Future.get()metody , wynik może być przechowywany w nowym obiekcie.

//get the future value and store in profile.
auto profile = profileFuture.get();

Łączenie go

Po pełnym zaimplementowaniu obserwatorów i delegata uwierzytelniania można teraz w pełni załadować profil. Poniższy fragment kodu zakłada, że wszystkie niezbędne nagłówki są już uwzględnione.

int main()
{
    const string userName = "MyTestUser@contoso.com";
    const string password = "P@ssw0rd!";
    const string clientId = "MyClientId";

    mip::ApplicationInfo appInfo {clientId, "APP NAME", "1.2.3" };

    std::shared_ptr<mip::MipConfiguration> mipConfiguration = std::make_shared<mip::MipConfiguration>(mAppInfo,
				                                                                                       "mip_data",
                                                                                        			   mip::LogLevel::Trace,
                                                                                                       false);

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

    ProtectionProfile::Settings profileSettings(
        mMipContext,                                    // mipContext object
        mip::CacheStorageType::OnDisk,                 // use on disk storage        
        std::make_shared<ConsentDelegateImpl>(),       // new consent delegate
        std::make_shared<ProfileObserver>());          // new protection profile observer

    auto profilePromise = std::make_shared<promise<shared_ptr<ProtectionProfile>>>();
    auto profileFuture = profilePromise->get_future();
    ProtectionProfile::LoadAsync(profileSettings, profilePromise);
    auto profile = profileFuture.get();
}

Wynik końcowy oznacza, że pomyślnie załadowaliśmy profil i zapisano go w obiekcie o nazwie profile.

Następne kroki

Po dodaniu profilu następnym krokiem jest dodanie aparatu do profilu.

Pojęcia dotyczące aparatu ochrony