Parametry
| mailbox | handle poštovní schránky |
| id | identifikátor zásilky |
| fileidx | pořadové číslo souboru z přílohy (počínaje od 0), má význam pouze pokud není zadáno jméno souboru z přílohy |
| filename | jméno souboru z přílohy, je-li zadán parametr fileidx, má hodnotu NIL (NULL) nebo prázdný řetězec |
| table | číslo tabulky nebo otevřeného kurzoru |
| pos | číslo záznamu |
| attr | číslo sloupce |
| index | vždy konstanta NOINDEX |
Od verze
7.0d
Popis
Uloží připojený soubor vybrané poštovní zásilky do tabulky table.
Načtení souborů připojených k zásilce může být provedeno dvěma způsoby. Jednak lze pomocí funkcí MailBoxLoad a MailBoxGetFilInfo získat seznam připojených souborů a informace o nich (jméno, datum apod.) a na disk uložit pouze vybrané soubory. Pokud potřebujeme získat všechny soubory a na jejich jménech nezáleží, lze v funkci MailBoxSaveFileAs volat v cyklu s parametrem fileidx rovným 0 až počet připojených souborů–1. Jestliže počet připojených souborů není předem znám, lze funkci volat dokud nevrátí chybu MAIL_NO_MORE_FILES.
Tabulka table musí existovat a mít vhodný řádek a sloupec.
Pro použití v jazyce SQL existuje obdobná funkce 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.
Viz