תכונות

סקירת תכונות

Aspose.Email FOSS for C++ מספק API בעל שכבות לעבודה עם קבצי Outlook MSG ו- מכולות Compound File Binary (CFB). הספרייה כוללת 26 מחלקות ציבוריות בשתי תתי‑מערכות: CFB ו‑MSG/MAPI.

CFB גישה למכולה

תת‑מערכת CFB קוראת וכותבת את פורמט Microsoft Compound File Binary — פורמט המכולה שמאחורי קבצי Outlook .msg.

פעולות מפתח:

• פתיחה מקובץ, זרם או בתים: cfb_reader::from_file(), cfb_reader::from_stream(), cfb_reader::from_bytes(), cfb_reader::from_buffer()
• רשימת תוכן: storage_ids(), stream_ids(), child_ids(), directory_entry_count()
• ניווט לפי נתיב: find_child_by_name(), resolve_path()
• בדיקת צמתים: cfb_node::is_storage(), cfb_node::is_stream(), creation_time(), modified_time()
• כתיבת מכולות: cfb_writer::to_bytes(), cfb_writer::write_file(), cfb_writer::write_stream()

קריאת וכתיבת קובץ MSG

תת‑מערכת MSG מטפלת בפורמט הודעות Outlook על גבי CFB.

פעולות מפתח:

• פתח קבצי MSG: msg_reader::from_file(), msg_reader::from_stream()
• בדוק מטא‑נתונים: msg_document::major_version(), msg_document::minor_version(), msg_document::strict()
• כתוב קבצי MSG: msg_writer::to_bytes(), msg_writer::write_file(), msg_writer::write_stream()
• המר ל‑CFB: msg_document::to_cfb_document() for low-level CFB access

API הודעות MAPI ברמה גבוהה

המחלקה mapi_message מספקת ממשק ברמה גבוהה ליצירה, קריאה והמרת הודעות דוא"ל.

יצירת הודעות:

• mapi_message::create() — בנה הודעה חדשה עם נושא וגוף
• set_subject(), set_body(), set_html_body() — הגדר תוכן הודעה
• set_sender_name(), set_sender_email_address(), set_sender_address_type() — הגדר שולח
• set_internet_message_id() — הגדר את כותרת Message-ID
• set_message_class() — הגדר מחלקת הודעה של MAPI
• unicode_strings() / set_unicode_strings() — שלוט בקידוד מחרוזת Unicode

טוען הודעות:

• mapi_message::from_file() — טעינה מנתיב קובץ
• mapi_message::from_stream() — טעינה מזרם קלט
• mapi_message::from_msg_document() — טעינה מmsg_document

שמירת הודעות:

• save() — להמיר לבייטים, זרם או קובץ
• to_msg_document() — להמיר ל-msg_document לגישה ברמת נמוכה

קבצים מצורפים:

• mapi_attachment::from_bytes(), mapi_attachment::from_stream() — טען נתוני קובץ מצורף
• mapi_attachment::is_embedded_message() — בדוק אם הקובץ המצורף הוא MSG משובץ
• mapi_attachment::load_data() — טען באופן עצל את תוכן הקובץ המצורף

תכונות MAPI:

• mapi_property::property_id(), property_type(), property_tag() — זיהוי נכסים
• mapi_property::set_value(), flags(), set_flags() — מניפולציה של נכסים
• mapi_property_collection::remove() — הסרת נכסים מאוסף

המרת EML ו‑MIME

המרה בין פורמט Outlook MSG לפורמט EML סטנדרטי (RFC 5322 / MIME):

• mapi_message::load_from_eml() — ניתוח קובץ .eml לmapi_message
• mapi_message::save_to_eml() — סריאליזציה של mapi_message לפורמט EML

הנושא, הגוף, השולח, הנמענים והקבצים המצורפים נשמרים במהלך נסיעות חוזרות.

מְעוּדּים וקבועים