MailGetProfileProp

c/c++pascalsql

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

Parametry

profile jméno poštovního profilu
propname jméno parametru poštovního profilu
propvalue výstupní parametr, hodnota parametru poštovního profilu
valsize velikost bufferu pro hodnotu

Od verze

8.0

Popis

Přečte hodnotu zadaného parametru poštovního profilu profile a uloží ji do výstupního bufferu. Heslo pro přístup k poště a heslo pro navázání telefonického spojení nelze pomocí této funkce zjistit.

Není-li parametr propname v profilu nalezen, vrátí funkce chybu 513. Je-li v profilu parametr s prázdnou hodnotou (což by při nastavování profilu pomocí klientského Vývojového prostředí nemělo nastat), funkce skončí bez chyby a ve výstupním parametru je prázdný string.

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