檔案 SDK - 處理電子郵件 .msg 檔案（C++）

發行項
01/30/2024

檔案 SDK 支援以與任何其他檔案類型相同的方式為 .msg 檔案套用標籤作業，但 SDK 需要應用程式才能啟用 MSG 功能旗標。在這裡，我們將瞭解如何設定此旗標。

如先前所述，的 mip::FileEngine 具現化需要設定物件 mip::FileEngineSettings 。 FileEngine設定可用來傳遞應用程式針對特定實例設定所需的自訂設定參數。 CustomSettings 的 mip::FileEngineSettings 屬性是用來設定旗 enable_msg_file_type 標，以啟用 .msg 檔案的處理。

必要條件

如果您尚未完成，請務必先完成下列必要條件，再繼續進行：

完成快速入門：檔案 SDK 應用程式初始化（C++）會先建置入門 Visual Studio 解決方案。本「如何 - 處理電子郵件訊息 .msg 檔案（C++）」快速入門以上一個快速入門為基礎。
檢閱快速入門：列出敏感度標籤（C++）。
檢閱快速入門：設定/取得敏感度標籤（C++）。
檢閱電子郵件檔案 MIP SDK 概念。
選擇性：檢閱 MIP SDK 概念中的檔案引擎。
選擇性：檢閱 MIP SDK 概念中的檔案處理常式。

必要條件實作步驟

開啟您在上一篇「快速入門：用戶端應用程式初始化（C++）》一文中建立的 Visual Studio 解決方案。
建立 PowerShell 腳本以產生存取權杖，如快速入門「列出敏感度標籤（C++）」中所述。
實作觀察者類別來監視， mip::FileHandler 如快速入門「設定/取得敏感度標籤（C++）」中所述。

設定enable_msg_file_type並使用檔案 SDK 來標記 .msg 檔案

在下方新增檔案引擎建構程式碼，以設定 enable_msg_file_type flag 並使用檔案引擎來標記 .msg 檔案。

使用 方案總管 ，在您的專案中開啟包含方法實作的 main() .cpp 檔案。它預設為與您在專案建立期間指定的專案相同名稱。

在檔案頂端的對應現有指示詞下方，新增下列 #include 和 using 指示詞：

#include "filehandler_observer.h" 
#include "mip/file/file_handler.h" 
#include <iostream>    
using mip::FileHandler;   
using std::endl;

從先前的快速入門中移除函式的實作 main() 。在主體內 main() ，插入下列程式碼。在下列程式碼區塊 enable_msg_file_type 旗標是在檔案引擎建立期間設定，然後可以使用檔案引擎建立的物件來處理 mip::FileHandler .msg 檔案。

int main()
{
    // Construct/initialize objects required by the application's profile object
    ApplicationInfo appInfo { "<application-id>",                    // ApplicationInfo object (App ID, name, version)
                              "<application-name>", 
                              "1.0" 
    };

    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);

    auto profileObserver = make_shared<ProfileObserver>();                      // Observer object
    auto authDelegateImpl = make_shared<AuthDelegateImpl>("<application-id>");  // Authentication delegate object (App ID)
    auto consentDelegateImpl = make_shared<ConsentDelegateImpl>();              // Consent delegate object

    // Construct/initialize profile object
    FileProfile::Settings profileSettings(mipContext,mip::CacheStorageType::OnDisk,authDelegateImpl,
        consentDelegateImpl,profileObserver);

    // Set up promise/future connection for async profile operations; load profile asynchronously
    auto profilePromise = make_shared<promise<shared_ptr<FileProfile>>>();
    auto profileFuture = profilePromise->get_future();
    try
    {
        mip::FileProfile::LoadAsync(profileSettings, profilePromise);
    }
    catch (const std::exception& e)
    {
        std::cout << "An exception occurred. Are the Settings and ApplicationInfo objects populated correctly?\n\n"<< e.what() << "'\n";
        system("pause");
        return 1;
    }

    auto profile = profileFuture.get();

    // Construct/initialize engine object
    FileEngine::Settings engineSettings(
                            mip::Identity("<engine-account>"),      // Engine identity (account used for authentication)
                            "<engine-state>",                       // User-defined engine state
                            "en-US");                               // Locale (default = en-US)

    //Set enable_msg_file_type flag as true
    std::vector<std::pair<string, string>> customSettings;
    customSettings.emplace_back(mip::GetCustomSettingEnableMsgFileType(), "true");
    engineSettings.SetCustomSettings(customSettings);

    // Set up promise/future connection for async engine operations; add engine to profile asynchronously
    auto enginePromise = make_shared<promise<shared_ptr<FileEngine>>>();
    auto engineFuture = enginePromise->get_future();
    profile->AddEngineAsync(engineSettings, enginePromise);
    std::shared_ptr<FileEngine> engine;

    try
    {
        engine = engineFuture.get();
    }
    catch (const std::exception& e)
    {
        cout << "An exception occurred... is the access token incorrect/expired?\n\n"<< e.what() << "'\n";
        system("pause");
        return 1;
    }

    //Set file paths
    string inputFilePath = "<input-file-path>"; //.msg file to be labeled
    string actualFilePath = inputFilePath;
    string outputFilePath = "<output-file-path>"; //labeled .msg file
    string actualOutputFilePath = outputFilePath;

    //Create a file handler for original file
    auto handlerPromise = std::make_shared<std::promise<std::shared_ptr<FileHandler>>>();
    auto handlerFuture = handlerPromise->get_future();

    engine->CreateFileHandlerAsync(inputFilePath,
                                    actualFilePath,
                                    true,
                                    std::make_shared<FileHandlerObserver>(),
                                    handlerPromise);

    auto fileHandler = handlerFuture.get();

    //List labels available to the user    

    // Use mip::FileEngine to list all labels
    labels = mEngine->ListSensitivityLabels();

    // Iterate through each label, first listing details
    for (const auto& label : labels) {
        cout << label->GetName() << " : " << label->GetId() << endl;

        // get all children for mip::Label and list details
        for (const auto& child : label->GetChildren()) {
            cout << "->  " << child->GetName() << " : " << child->GetId() << endl;
        }
    }

    string labelId = "<labelId-id>"; //set a label ID to use

    // Labeling requires a mip::LabelingOptions object. 
    // Review API ref for more details. The sample implies that the file was labeled manually by a user.
    mip::LabelingOptions labelingOptions(mip::AssignmentMethod::PRIVILEGED);

    fileHandler->SetLabel(labelId, labelingOptions, mip::ProtectionSettings());

    // Commit changes, save as outputFilePath
    auto commitPromise = std::make_shared<std::promise<bool>>();
    auto commitFuture = commitPromise->get_future();

    if(fileHandler->IsModified())
    {
        fileHandler->CommitAsync(outputFilePath, commitPromise);
    }
    
    if (commitFuture.get()) {
        cout << "\n Label applied to file: " << outputFilePath << endl;
    }
    else {
        cout << "Failed to label: " + outputFilePath << endl;
        return 1;
    }

    // Create a new handler to read the label
    auto msgHandlerPromise = std::make_shared<std::promise<std::shared_ptr<FileHandler>>>();
    auto msgHandlerFuture = handlerPromise->get_future();

    engine->CreateFileHandlerAsync(inputFilePath,
                                    actualFilePath,
                                    true,
                                    std::make_shared<FileHandlerObserver>(),
                                    msgHandlerPromise);

    auto msgFileHandler = msgHandlerFuture.get();

    cout << "Original file: " << inputFilePath << endl;
    cout << "Labeled file: " << outputFilePath << endl;
    cout << "Label applied to file : " 
            << msgFileHandler->GetName() 
            << endl;
    
    // Application shutdown. Null out profile, engine, handler.
    // Application may crash at shutdown if resources aren't properly released.
    msgFileHandler = nullptr;
    fileHandler = nullptr;
    engine = nullptr;
    profile = nullptr;
    mipContext = nullptr;

    return 0;
}

如需檔案作業的進一步詳細資料，請參閱檔案處理常式概念。

使用下列值取代原始程式碼中的預留位置值：

預留位置	值
<application-id>	向 Microsoft Entra 租使用者註冊的應用程式識別碼，例如： `0edbblll-8773-44de-b87c-b8c6276d41eb` 。
<engine-account>	用於引擎身分識別的帳戶，例如： `user@tenant.onmicrosoft.com` 。
<engine-state>	使用者定義的應用程式狀態，例如： `My engine state` 。
<input-file-path>	測試輸入訊息檔的完整路徑，例如： `c:\\Test\\message.msg` 。
<output-file-path>	輸出檔案的完整路徑，這會是輸入檔的標籤複本，例如： `c:\\Test\\message_labeled.msg` 。
<label-id>	使用 `ListSensitivityLabels` 擷取的 labelId，例如： `667466bf-a01b-4b0a-8bbf-a79a3d96f720` 。

建置及測試應用程式

使用 F6 （建置解決方案）來建置用戶端應用程式。如果您沒有建置錯誤，請使用 F5 （開始偵錯）來執行應用程式。

共用方式為

檔案 SDK - 處理電子郵件 .msg 檔案（C++）

必要條件

必要條件實作步驟

設定enable_msg_file_type並使用檔案 SDK 來標記 .msg 檔案

建置及測試應用程式

意見反應

其他資源

共用方式為

檔案 SDK - 處理電子郵件 .msg 檔案 （C++）

必要條件

必要條件實作步驟

設定enable_msg_file_type並使用檔案 SDK 來標記 .msg 檔案

建置及測試應用程式

意見反應

其他資源

檔案 SDK - 處理電子郵件 .msg 檔案（C++）