MailBoxSaveFileAs

c/c++pascalsql

DWORD MailBoxSaveFileAs(DWORD mailbox, DWORD id, DWORD fileidx, char *filename, char *destpath);
function MailBoxSaveFileAs(mailbox : integer; id : integer; fileidx : integer; var filename : string; var destpath : string) : integer;
FUNCTION MailBoxSaveFileAs(IN mailbox INT, IN id INT, IN fileidx INT, INOUT filename CHAR(255), IN destpath CHAR(255)) RETURNS INT;

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
destpath cesta (včetně jména souboru), kam se má soubor z přílohy uložit

Od verze

6.0f

Popis

Uloží připojený soubor vybrané poštovní zásilky na disk.

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.

Adresář obsažený v parametru destpath musí existovat.

Příklad

Příklad příjmu zásilky

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