4D Doc Center : SMTP

4D Internet Commands v12.1

SMTP_QuickSend


SMTP_QuickSend ( hostName ; msgFrom ; msgTo ; subject ; message {; sessionParam} ) -> 戻り値

引数	型	説明
hostName	文字	ホスト名またはIPアドレス
msgFrom	テキスト	送信元MailAddress または AddressList
msgTo	テキスト	送信先MailAddress または AddressList
subject	テキスト	件名
message	テキスト	メッセージ本文
sessionParam	倍長整数	1 = SSLを使用, 0または省略 = SSLを使用しない
戻り値	整数	エラーコード

説明

SMTP_QuickSend コマンドは、一つのコマンドでメールの構築と送信を可能にします。メッセージに対する詳細なコントロールが必要な場合は、SMTP_New コマンドをはじめとするSMTP関連のコマンドを使用します。

hostName はSMTPサーバのホスト名またはIPアドレスで、配送するメッセージを中継するサーバです。

msgFrom は、メールの送信人を表す一つ以上の完全なMailAddress または AddressListです。Fromヘッダに書かれたすべてのアドレスはメッセージの受信者から閲覧可能です。

msgTo は、一つ以上の完全なAddressListを含みます。msgTo ヘッダに記載されたAddressListにそれぞれメッセージが送信されます。それぞれの受信者は、他の受信者のアドレスを見ることができます。

subject にはメールの件名を渡します。

警告：通常、メッセージの件名には (é, ö などの) アクセント文字を含めるべきではありません。これらの拡張文字を使用したい場合は、SMTP_SetPrefs と SMTP_Charset コマンドの説明を参照してください。

messageはメールメッセージのボディテキストを渡します。過去の経緯からメッセージサイズは32 KBに制限されます。

オプションのsessionParam引数を使用すると、接続にSSLプロトコルを使用することができます:

1を渡すと、SMTPサーバーへの接続はSSLで行われます (同期モード)、
0を渡すかこの引数を省略すると、接続は標準の非保護モードで行われます。

例題

以下はこのコマンドの使用例です:

 $Host:="www.4d.com"

 $ToAddress:="adupont@4d.fr"

 $FromAddress:="jsmith@4d.com"

 $Subject:="Sales Report"

 $Message:="Can you send me the sales report for January 2000? Thanks."

 $Error:=SMTP_QuickSend($Host;$FromAddress;$ToAddress;$Subject;$Message;1)

 If($Error#0)

    ALERT("Error: SMTP_QuickSend"+Char(13)+IT_ErrorText($Error))

 End If