MailSetProfileProp

c/c++pascalsql

int MailSetProfileProp(const char *profile, const char *propname, DWORD const char *propvalue);
function MailSetProfileProp(profile : PChar; propname : PChar; propvalue : PChar); integer;
FUNCTION MailSetProfileProp(INOUT profile : CHAR(63), INOUT propname : CHAR(63), INOUT propvalue : CHAR(255)) RETURNS INT;

Parametry

profile jméno poštovního profilu
propname jméno parametru poštovního profilu
propvalue nová hodnota parametru poštovního profilu

Od verze

8.0

Popis

Přidělí zadanému parametru poštovního profilu novou (neprázdnou) hodnotu; pokud parametr propname neexistuje, vytvoří jej. Standardní (trvalé) profily může modifikovat pouze provozní správce databáze, dočasný profil může měnit každý uživatel s výjimkou parametru FilePath. Heslo pro přístup k poště a heslo pro navázání telefonického spojení nelze pomocí této funkce měnit.

Touto funkcí nelze zadat prázdnou hodnotu parametru profilu.

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