KKmail 邮件组件参考手册
SMTPClient 对象
　　KKmail 邮件发送对象，能对 HTML 内容和 TEXT 纯文本内容，以及本地二进制的附件文件进行编码，生成符合 RFC (Request for Comments) 标准的邮件数据，并通过标准的 Internet 邮件传输协议，将邮件数据传送到指定的 SMTP 服务器中。
属性列表
属性 数据类型 描述
Authentication 整数 [W] 设置 SMTP 服务器是否需要发送身份验证，(为了防止用户邮件账号被恶意用以发送垃圾邮件，当今几乎所有的 SMTP 服务器都需要进行发送身份验证):
0:　关闭发送身份验证
1:　启用发送身份验证　(默认值)
HELO 字符串 [RW] 设置或读取邮件发送通讯指令 HELO / EHLO 的值，默认值为本地发送主机的计算机名称
Host 字符串 [W] 设置 SMTP 服务器地址或IP
HtmlEncodeType 整数 [W] 设置 HTML 内容编码方式:
0:　BASE64　(默认值)
1:　Quoted-Printable
HtmlImplantFile 整数 [W] 设置是否将 HTML 内容中包含本地的图片资源，自动将其包含在邮件的内嵌资源中:
0:　否　(默认值)
1:　是
InvokePath 字符串 [RW] 设置或读取调用 KKmail 的主应用程序路径，默认值位 KKmail 文件的所在路径
LocalHostName 字符串 [R] 返回本地计算机的主机名称
LocalIP 字符串 [R] 返回本地计算机的主机IP地址
LogFile 字符串 [RW] 指定或返回日志记录文件，默认值为与 KKmail 文件相同目录里的 KKmail.log 文件
Logging 整数 [RW] 设置或读取是否启用日志记录:
0:　否　(默认值)
1:　是
Mailer 字符串 [RW] 设置或读取邮件头 X-Mailer 域信息
MailFrom 字符串 [W] 设置发送者邮件地址，邮件地址必须符合 RFC821 格式要求的一个完整的邮件地址
MailFromAlias 字符串 [W] 设置发送者别名
MailHtml 字符串 [W] 设置需要发送的 HTML 内容
MailSource 字符串 [R] 返回当前准备发送的邮件源码数据，此数据为经过编码 MIME 文本
MailText 字符串 [W] 设置需要发送的 TEXT 纯文本内容
MIMEVersion 字符串 [RW] 设置或读取邮件头 MIME-Version 域信息，目前是 1.0 ，建议不要修改此项
Notification 整数 [W] 设置是否请求阅读回执:
0:　否　(默认值)
1:　是
Password 字符串 [W] 设置 SMTP 服务器用户密码
Port 整数 [W] 设置 SMTP 服务器通讯端口，默认值为 25，一般情况不需要修改
Priority 整数 [W] 设置发送邮件的优先级别: 1 高, 3 普通, 5 低，默认值为 3 普通
RegKey 字符串 [W] 设置 KKmail 注册码
RegUser 字符串 [W] 设置 KKmail 注册用户账号
ReplyTo 字符串 [W] 设置邮件回信地址。有可能存在情况: 接收人邮件服务器检测出检测 MailFrom 与 ReplyTo 不相符，有可能将邮件定为垃圾邮件，因此 KKmail 建议，ReplyTo 的值最好与 MailFrom 一致
ReplyToAlias 字符串 [W] 设置邮件回信别名
SendTo 字符串 [W] 设置邮件接收地址，邮件地址必须符合 RFC821 格式要求的一个完整的邮件地址
SendToAlias 字符串 [W] 设置接收者别名
State 整数 [R] 返回当前工作状态: 8 待命,准备就绪; 16 工作任务进行中。当 State 的值处于 16 时，要求 SMTPClient 对象的 SendMail 方法将会执行失败，需等待当前任务执行完毕后，方可执行
Subject 字符串 [W] 设置发送邮件的主题
TextEncodeType 整数 [W] 设置 TEXT 纯文本内容编码方式:
0:　BASE64　(默认值)
1:　Quoted-Printable
TimeoutSecond 整数 [RW] 设置与返回跟服务器通讯的指令时限，单位: 秒，每个通讯指令超过此属性值，将会发生超时中断任务，默认值为 10 秒
User 字符串 [W] 设置 SMTP 服务器用户账号

说明: 以上属性项并非全部同时支持读与写: [R] 只读; [W] 只写; [RW] 可读写
方法
  • SendMail
    语法:　SendMail　[psHost],　[psUser],　[psPassword],　[plPort],　[psMailSource],　[psEMLFile]
    描述:　将邮件数据发送至指定的 SMTP 服务器中
    返回:　0 发送成功;　非0 数值为发送失败
    参数:
    参数 数据类型 描述
    psHost 字符串 可选参数，SMTP 服务器地址或IP，并同时修改 Host 属性值
    psUser 字符串 可选参数，SMTP 服务器用户账号，并同时修改 User 属性值
    psPassword 字符串 可选参数，SMTP 服务器用户密码，并同时修改 Password 属性值
    plPort 整数 可选参数，SMTP 服务器通讯端口，默认值为 25，并同时修改 Port 属性值
    psMailSource 字符串 可选参数，指定发送的邮件数据内容
    psEMLFile 字符串 可选参数，发送本地的 eml 邮件文件
  • AddCCIncept
    语法:　AddCCIncept　psCCAddress
    描述:　添加抄送地址。所添加的抄送地址，将会添加在邮件头 Cc 域信息里，接收人将会看到当前邮件所有被抄送的地址
    参数:　psCCAddress 需要抄送的邮件地址
  • AddBCCIncept
    语法:　AddBCCIncept　psBCCAddress
    描述:　添加暗送地址。所添加的暗送地址，将不会编码到邮件信息里， 并且接收人不会看到当前邮件所有被暗送的地址
    参数:　psBCCAddress 需要暗送的邮件地址
  • AddAttachment
    语法:　AddAttachment　psFileName
    描述:　添加附件文件
    参数:　psFileName 被作为邮件附件的本地计算机文件的路径与名称
  • SaveToFile
    语法:　SaveToFile　psFileName
    描述:　将当前准备发送的邮件源码数据 (此数据为经过编码 MIME 文本) 保存为 .eml 邮件文件
    参数:　psFileName 保存的目标文件的路径与名称
  • ConnectClose
    语法:　ConnectClose
    描述:　关闭与远程 SMTP 服务器的连接，并重置 SMTPClient 对象的属性为初始化状态
    参数:　无参数
示例　　[显示↓]
参阅
　　POP3Client 对象　|　CoreEncoder 对象　|　RegAccess 对象　|　TaskTimer 对象　|　Registration 对象
©　2009　[Veranda Studio]　Duclika    粤ICP备13043883号-1 返回顶部