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 | jméno tabulky, do které se bude ukládat (obecně tam může být cokoliv, co může být v SELECTU za FROM) |
| attr | jméno sloupce, do kterého se bude ukládat (musí to být sloupec proměnné délky typu CLOB nebo BLOB) |
| cond | výběrová podmínka, která identifikuje záznam, do kterého se bude ukládat (podmínka musí vybrat právě jeden záznam, jiný počet vybraných záznamů způsobí výjimku 21000 (SQ_CARDINALITY_VIOLATION)) |
Od verze
7.0d
Popis
Uloží připojený soubor vybrané poštovní zásilky do tabulky table. Pro výběr záznamu je použito SQL podmínky (na rozdíl od obdobné funkce MailBoxSaveFileDBr, která určuje záznam k uložení souboru způsobem používaným v klientském jazyce).
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.
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