MailCreateProfile

c/c++pascalsql

INT MailCreateProfile(const char *profile, BOOL temp);
function MailCreateProfile(profile : Pchar; temp : Boolean); integer;
FUNCTION MailCreateProfile(INOUT profile CHAR(63), IN temp BOOLEAN) RETURNS INT;

Parametry

profile jméno poštovního profilu
temp příznak – dočasný profil

Od verze

8.0

Popis

Vytvoří nový prázdný poštovní profil. Pokud je nastaven parametr temp, vytvoří se dočasný profil, který se nikam trvale neukládá. Dočasný profil lze použít na inicializaci pošty jako kterýkoli běžný profil, automaticky zanikne po ukončení práce s poštou zavoláním funkce CloseWBMail. Standardní (trvalé) profily může vytvářet pouze provozní správce databáze, dočasný profil může vytvářet každý uživatel.

Hodnota funkce

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

Příklad

nahradit v profilu zadanou odesílací adresu z pevného profilu (vlatnost MyAdress) jinou adresou:

// je trvalý profil typu SMTP?
SET Err=MailGetProfileProp(profile,"SMTPServer",smtp_server,100); 
// jestliže ano, uděláme nový dočasný profil se stejným SMTP serverem (a případně dalšími vlastnostmi) 
// a nahradíme adresu 
IF Err=0 THEN     
  SET nova_adresa = ...;
  CALL MailCreateProfile("_temporary",TRUE);
  CALL MailSetProfileProp("_temporary","SMTPServer",smtp_server);
  CALL MailSetProfileProp("_temporary","MyAddress",nova_adresa);

Viz