الوصول إلى خصائص 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 المسماة

Named MAPI properties هي خصائص مخصصة يضيفها المستخدمون أو التطبيقات.

Aspose.Email يتيح قراءة هذه الخصائص من الرسائل والمرفقات.

قراءة خصائص MAPI المُسماة من ملفات MSG

يعرض مثال الشيفرة التالي كيفية تحميل ملف رسالة MAPI، استرجاع جميع خصائص MAPI المُسمَّاة الخاصة به، والتكرار عبرها للعثور على قيم خصائص مُسمَّاة محددة ("TEST" و "MYPROP") وعرضها. يوضح كيفية الوصول إلى الخصائص المخصصة أو الموسعة في رسالة MAPI عن طريق تعداد مجموعة الخصائص ومعالجة الخصائص بشكل شرطي بناءً على معرفات أسمائها.

الوصول إلى خصائص MAPI المُسماة في المرفقات

يمكن استرجاع خصائص MAPI المُسماة في المرفقات بطريقة مماثلة:

إزالة خصائص MAPI

يمكنك إزالة كل من الخصائص القياسية والمسمَّاة لـ MAPI من الرسائل أو المرفقات كما هو موضح في مثال الشيفرة أدناه: