Outlook MAPI Özelliklerine Eriş ve Yönet

MAPI properties Microsoft Outlook mesajlarında kullanılan, gönderici, alıcı, konu, ekler ve özelleştirilmiş veri gibi nitelikleri tanımlayan meta veri öğeleridir.

Aspose.Email for C++ geliştiricilerin bu özelliklere programatik olarak erişmesini, değiştirmesini ve kaldırmasını sağlar. MapiMessage nesneler, ekler ve adlandırılmış özellikler.

Bu MapiProperty sınıf, şu öğeleri içeren bir MAPI özelliğini temsil eder:

  • Name – Özelliğin dize tanımlayıcısı.
  • Tag – Özelliği başvurmak için kullanılan sayısal tanımlayıcı.
  • Data – Özelliğin değerini temsil eden bir bayt dizisi.

MAPI Özelliklerini Oku

Aspose.Email, özellik etiketlerini kullanarak MAPI özelliklerini okumanızı sağlar.

Aşağıdaki kod örneği, bir MAPI mesaj dosyasından (.msg) konu özelliğini okuma ve gösterme işlemini açıklar.

  1. Outlook mesaj dosyalarının depolandığı dizin yolunu alın.
  2. Outlook mesaj dosyasını ("message.msg") bir MapiMessage nesne.
  3. Mesajdan MAPI özelliklerinin koleksiyonuna eriş.
  4. Konu özelliğini şunu kullanarak almaya çalışın PR_SUBJECT (ANSI) etiket.
  5. ANSI konu özelliği bulunamazsa, Unicode konu özelliğini şunu kullanarak almaya çalışın PR_SUBJECT_W.
  6. Konu özelliği mevcutsa, dize değerini konsola yazdır.

MAPI Özelliklerini Ayarla

MAPI özellikleri, mesajlar veya alıcılar için özel nitelikler, e-posta türü veya senkronizasyon durumu tanımlamak amacıyla ayarlanabilir.

Aşağıdaki kod örneği, bir MAPI mesajı oluşturmayı, gönderici ve alıcı ayrıntıları, mesaj bayrakları ve değiştirme zamanı dahil olmak üzere birden çok özel MAPI özelliği ayarlamayı ve ardından mesajı bir dosyaya kaydetmeyi göstermektedir.

Not: ConvertDateTime() yardımcı işlevi, System::DateTime’ı tarih/saat özellikleri için MAPI uyumlu bir filetime bayt dizisine aşağıdaki şekilde dönüştürür:

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

Adlandırılmış MAPI Özelliklerini Okuma

Adlandırılmış MAPI özellikleri kullanıcılar veya uygulamalar tarafından eklenen özel özelliklerdir.

Aspose.Email, bu özellikleri mesajlardan ve eklerden okuma imkanı sağlar.

MSG Dosyalarından Adlandırılmış MAPI Özelliklerini Okuma

Aşağıdaki kod örneği, bir MAPI mesaj dosyasını nasıl yükleyeceğinizi, tüm adlandırılmış MAPI özelliklerini nasıl alacağınızı ve bunlar arasında belirli adlandırılmış özelliklerin ("TEST" ve "MYPROP") değerlerini bulup görüntülemek için nasıl döneceğinizi göstermektedir. Özellik koleksiyonunu enumerate ederek ve ad tanımlayıcılarına göre koşullu işlem yaparak bir MAPI mesajındaki özel veya genişletilmiş özelliklere nasıl erişileceğini gösterir.

Eklerde Adlandırılmış MAPI Özelliklerine Erişim

Eklerdeki adlandırılmış MAPI özellikleri de benzer şekilde alınabilir:

MAPI Özelliklerini Kaldırma

Aşağıdaki kod örneğinde gösterildiği gibi, mesajlardan veya eklerden hem standart hem de adlandırılmış MAPI özelliklerini kaldırabilirsiniz: