Parametry
| mailbox | handle poštovní schránky |
| flag | rozsah zápisu |
Od verze
6.0f
Popis
Funkce přečte z poštovní schránky (v profilu zvoleného) poštovního systému seznam zásilek a zapíše jej do databáze. Údaje o zásilkách se zapisují do speciálních tabulek _INBOXMSGS a _INBOXFILES v aplikaci určené v profilu (implicitně v systémové aplikaci _Sysext).
Pokud se z poštovního serveru opakovaně stahuje stejná zásilka, v poštovních tabulkách se nevytváří nový záznam, ale aktualizuje se starý. Dle obsahu sloupce Stat lze zjistit, zda zásilka byla již dříve stažena.
Množství informací, které lze o zásilce získat ze seznamu zásilek se liší podle použité pošty. Nejste-li si jisti, pro který systém aplikaci píšete, předpokládejte POP3 protokol, ten je nejstručnější.
Rozsah zápisu lze řídit pomocí parametru flag. Hodnota parametru může být součtem hodnot:
| 0 | Do databáze se uloží jen seznam zásilek | |
MBL_BODY
|
1 | Do databáze se uloží také texty dopisů včetně hlavičky (do sloupce |
MBL_FILES
|
2 | Do databáze se uloží také informace o připojených souborech (sloupec FileCnt a sloupce v tabulce _INBOXFILES) |
MBL_HDRONLY
|
4 | Do databáze se uloží jen hlavičky (sloupec Header) |
MBL_MSGONLY
|
8 | Do databáze se uloží jen texty dopisů (sloupec Body) |
Hodnota MBL_BODY se vylučuje s hodnotami MBL_HDRONLY a MBL_MSGONLY. Hodnota MBL_HDRONLY nefunguje v případě MAPI pošty.
Získat text dopisu nebo seznam připojených souborů může znamenat, podle použité pošty, stažení celé zásilky z Internetu nebo vzdáleného poštovního úřadu, což operaci načtení seznamu zásilek neúměrně prodlouží. Pokud se texty dopisů nezískají přímo touto funkcí, lze to provést později pro jednotlivé zásilky funkce MailBoxGetMsgEx. Informace o připojených souborech pro jednotlivé zásilky lze později získat pomocí funkce MailBoxGetFilInfo. Uložení připojeného souboru na disk provádí funkce MailBoxSaveFileAs. Uložení připojeného souboru do tabulky provádí klientská funkce MailBoxSaveFileDBr nebo v SQL MailBoxSaveFileDBs.
Hodnota funkce
Funkce vrací nulu v případě úspěchu a číslo chyby v případě neúspěchu. Číslo chyby lze zjistit také pomocí Sz_error nebo Signalize.
Příklad
Viz