גישה וניהול של מאפייני MAPI של Outlook

MAPI properties הן פריטי מטא‑נתונים המשמשים בהודעות Microsoft Outlook, מגדירים תכונות כגון משגר, נמען, נושא, קבצים מצורפים ונתונים מותאמים.

Aspose.Email for C++ מאפשר למפתחים לגשת, לשנות ולהסיר מאפיינים אלה תכנותית ב MapiMessage אובייקטים, קבצים מצורפים ומאפיינים ממונים.

ה MapiProperty מחלקה המייצגת תכונת MAPI, הכוללת:

• Name – מזהה המחרוזת של המאפיין.
• Tag – מזהה מספרי המשמש להפניה למאפיין.
• Data – מערך בתים המייצג את ערך המאפיין.

קריאת מאפייני MAPI

Aspose.Email מאפשרת לקרוא מאפייני MAPI באמצעות תגיות מאפיינים.

דוגמת הקוד הבאה מציגה כיצד לקרוא ולהציג את תכונת הנושא מקובץ הודעת MAPI (.msg).

1. קבל את נתיב הספרייה שבה מאוחסנים קבצי הודעות Outlook.
2. טען את קובץ הודעת Outlook ("message.msg") לתוך MapiMessage אובייקט.
3. גש לאוסף של מאפייני MAPI מההודעה.
4. נסה לאחזר את תכונת הנושא באמצעות PR_SUBJECT (ANSI) תגית.
5. אם תכונת הנושא ב‑ANSI לא נמצאה, נסה לאחזר את תכונת הנושא ב‑Unicode באמצעות PR_SUBJECT_W.
6. אם תכונת הנושא קיימת, הצג את ערך המחרוזת שלה בקונסול.

הגדרת תכונות MAPI

ניתן להגדיר מאפייני MAPI עבור הודעות או נמענים כדי לקבוע תכונות מותאמות, סוג דוא״ל או מצב סינכרון.

דוגמאות הקוד הבאות מראות כיצד ליצור הודעת MAPI, להגדיר מספר מאפייני MAPI מותאמים כולל פרטי משגר ונמען, דגלי הודעה וזמן שינוי, ולאחר מכן לשמור את ההודעה לקובץ.

הערה: הפונקציה העזרית ConvertDateTime() ממירה System::DateTime למערך בתים של FileTime תואם MAPI עבור מאפייני תאריך/זמן באופן הבא:

int64_t filetime = t.ToFileTime();

System::ArrayPtr<uint8_t> d = System::MakeArray<uint8_t>(8, 0);

d[0] = (uint8_t)(filetime & 0xFF);

d[1] = (uint8_t)((filetime & 0xFF00) >> 8);

d[2] = (uint8_t)((filetime & 0xFF0000) >> 16);

d[3] = (uint8_t)((filetime & 0xFF000000) >> 24);

d[4] = (uint8_t)((filetime & 0xFF00000000) >> 32);

d[5] = (uint8_t)((filetime & 0xFF0000000000) >> 40);

d[6] = (uint8_t)((filetime & 0xFF000000000000) >> 48);

d[7] = (uint8_t)(((uint64_t)filetime & 0xFF00000000000000) >> 56);

קריאת מאפייני MAPI בשם

מאפייני MAPI ממונים הם מאפיינים מותאמים שנוספו על ידי משתמשים או יישומים.

Aspose.Email מאפשר קריאת המאפיינים האלה מהודעות וקבצים מצורפים.

קריאת מאפייני MAPI ממונים מקבצי MSG

דוגמת הקוד הבאה מציגה כיצד לטעון קובץ הודעת MAPI, לאסוף את כל המאפיינים הממונים שלה, ולחזור עליהם כדי למצוא ולהציג את הערכים של מאפיינים ממונים ספציפיים ("TEST" ו‑"MYPROP"). היא מראה כיצד לגשת למאפיינים מותאמים או מורחבים בהודעת MAPI על‑ידי מיפוי אוסף המאפיינים ועיבוד מותנה של המאפיינים על סמך מזהי שמם.

גישה למאפייני MAPI ממונים בקבצים מצורפים

ניתן לאחזר מאפייני MAPI ממונים בקבצים מצורפים באופן דומה:

הסרת מאפייני MAPI

ניתן להסיר הן את מאפייני MAPI הסטנדרטיים והן את הממונים מהודעות או קבצים מצורפים כפי שמודגם בדוגמת הקוד למטה: