LetterCreate

c/c++pascalsql

int LetterCreate(char * subj, char * msg, UINT flags, DWORD * letter);
function LetterCreate(subj, msg : PChar; flags : integer; var letter : integer) : integer;
FUNCTION LetterCreate (IN subj CHAR(80), IN msg CLOB, IN flags INT, OUT letter INT) RETURNS INT;

Parametry

subj "věc" dopisu (objeví se v seznamu došlé pošty)
msg text dopisu nebo cesta k textovému souboru obsahujícímu text dopisu
flags příznaky dopisu WBL_...
letter výstupní parametr - handle dopisu

Popis

Vytvoří novou zásilku elektronické pošty označenou parametrem letter. Tento parametr identifikuje zásilku a ostatní funkce (přidání adresáta, připojení souboru apod.) pracují s tímto identifikátorem.

Příznaky dopisu flags:

WBL_READRCPT (= 1) Zásilka bude doporučená.
WBL_DELAFTER (= 2) Zásilka bude po odeslání smazána. MAPI implicitně odeslané zásilky neruší a ponechává je v přihrádce pošta k odeslání.

Následující dva příznaky specifikují prioritu zásilky. Implicitně má zásilka prioritu normální.

WBL_PRILOW ( = 4) Odeslání zásilky bude mít nízkou prioritu
WBL_PRIHIGH (= 8) Odeslání zásilky bude mít vysokou prioritu. Uživatel pošty Mail602 musí mít povoleno vysokou prioritu používat, jinak při odeslání zásilky dojde k chybě NO_RIGHT (129).

Následující tři příznaky specifikují citlivost zásilky. Implicitně nemá zásilka žádnou citlivost. Pošta Mail602 nastavování citlivosti zásilky nepodporuje.

WBL_SENSPERS (= 16) Zásilka bude mít "Osobní" citlivost, tzn. že zásilka neobsahuje informace týkající se pracovních záležitostí.
WBL_SENSPRIV (= 32) Zásilka bude mít "Soukromou" citlivost, příjemci nebude umožněno obsah zásilky před odesláním odpovědi nebo postoupením změnit.
WBL_SENSCONF (= 64) Zásilka bude mít "Důvěrnou" citlivost, se zásilkou by mělo zacházeno podle příslušných zásad.

WBL_REMSENDNOW (= 128) Zásilka bude záhy po zařazení do pošty odeslána na mateřský poštovní úřad (v případě vzdáleného klienta pošty Mail602) nebo na zvolený SMTP server (v případě tohoto nastavení v profilu Mail602).
WBL_MSGINFILE (= 256) Je-li příznak nastaven, parametrem Msg je jméno textového souboru, který obsahuje tělo dopisu, jinak je parametrem Msg přímo text dopisu. V případě těla v souboru musí být soubor v 8-bitovém kódování (pro LetterCreate), resp. v UCS-2 (pro LetterCreateW).
WBL_BCC (=512) obsahuje-li dopis více adresátů, rozešlou se všem tzv. "slepé kopie" (bez uvedení ostatních adresátů) - pouze pro Mail602
WBL_DELFAFTER (=1024) pokud nedošlo při odesílání k chybě, smaže po odeslání soubory připojené k dopisu


Unicodová varianta funkce

LetterCreateW

sql

FUNCTION LetterCreateW (IN subj NCHAR(80), IN msg NCLOB, IN flags INT, OUT letter INT) RETURNS INT;

Obecnější varianta funkce LetterCreate. Pokud není možno zajistit, aby text dopisu (a subjectu) byly v systémovém kódování serveru, použijte tuto variantu, jinak se ztratí znaky s diakritikou.



Hodnota funkce

Funkce vrací nulu v případě úspěchu a číslo chyby v případě neúspěchu. Číslo chyby lze také zjistit pomocí Sz_error nebo Signalize.

Příklad

Příklad odeslání zásilky

Viz