Přístup a správa Outlook MAPI vlastností

MAPI properties jsou položky meta dat používané ve zprávách Microsoft Outlook, definující atributy jako odesílatel, příjemce, předmět, přílohy a vlastní data.

Aspose.Email for C++ umožňuje vývojářům programově přistupovat k těmto vlastnostem, měnit je a odstraňovat je v MapiMessage objekty, přílohy a pojmenované vlastnosti.

The MapiProperty třída představuje MAPI vlastnost, která obsahuje:

• Name – Řetězcový identifikátor vlastnosti.
• Tag – Číselný identifikátor používaný k odkazu na vlastnost.
• Data – Pole bajtů představující hodnotu vlastnosti.

Číst MAPI vlastnosti

Aspose.Email vám umožňuje číst MAPI vlastnosti pomocí tagů vlastností.

Následující ukázka kódu demonstruje, jak přečíst a zobrazit vlastnost předmětu ze souboru MAPI zprávy (.msg).

1. Získejte cestu k adresáři, kde jsou uloženy soubory Outlook zpráv.
2. Načtěte soubor Outlook zprávy ("message.msg") do MapiMessage objektu.
3. Přístup ke kolekci MAPI vlastností ze zprávy.
4. Zkuste získat vlastnost předmětu pomocí PR_SUBJECT (ANSI) tagu.
5. Pokud není nalezena ANSI vlastnost předmětu, zkuste získat Unicode vlastnost předmětu pomocí PR_SUBJECT_W.
6. Pokud existuje vlastnost předmětu, vypište její řetězcovou hodnotu do konzole.

Nastavit MAPI vlastnosti

MAPI vlastnosti lze nastavit pro zprávy nebo příjemce k definování vlastních atributů, typu e‑mailu nebo stavu synchronizace.

Následující ukázkový kód demonstruje, jak vytvořit MAPI zprávu, nastavit několik vlastních MAPI vlastností včetně podrobností o odesílateli a příjemci, příznaků zprávy a času úpravy, a poté zprávu uložit do souboru.

Poznámka: Pomocná funkce ConvertDateTime() převádí System::DateTime na pole bajtů filetime kompatibilní s MAPI pro datum/časové vlastnosti následujícím způsobem:

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

Číst pojmenované MAPI vlastnosti

Named MAPI properties jsou vlastní vlastnosti přidané uživateli nebo aplikacemi.

Aspose.Email umožňuje číst tyto vlastnosti ze zpráv a příloh.

Čtení pojmenovaných MAPI vlastností ze souborů MSG

Následující ukázkový kód demonstruje, jak načíst soubor MAPI zprávy, získat všechny jeho pojmenované MAPI vlastnosti a projít je, aby se našly a zobrazily hodnoty konkrétních pojmenovaných vlastností ("TEST" a "MYPROP"). Ukazuje, jak získat přístup k vlastním nebo rozšířeným vlastnostem v MAPI zprávě enumerací kolekce vlastností a podmíněným zpracováním vlastností na základě jejich názvových identifikátorů.

Přístup k pojmenovaným MAPI vlastnostem v přílohách

Pojmenované MAPI vlastnosti v přílohách lze získat podobně:

Odstraňování MAPI vlastností

Můžete odstranit jak standardní, tak pojmenované MAPI vlastnosti ze zpráv nebo příloh, jak ukazuje ukázkový kód níže: