4D Doc Center : SMTP

4D v13.2

SMTP_QuickSend


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

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

説明

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プロトコルのアクティベーションモードを設定できます:

0を渡すかこの引数を省略すると、接続は標準の非保護モードで行われます。認証後にサーバーからSSL/TLSへの更新を要求された場合、スイッチは自動で行われます (explicitモードのSSL/TLS)。
1を渡すと、SMTPサーバーへの接続はSSLで行われます (同期モード)、
2を渡すと、接続は標準の非保護モードで行われます。SSL/TLSへの更新は行われません。

例題 1

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

 $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

例題 2

MS Exchange serverにセキュアモードでメールを送信する例題:

 $ServerName:="exchange.4d.com"

 $MsgTo:="adupont@gmail.com"

 $MsgFrom:="a.user@4d.com"

 $Subject:="Test message"

 $Message:="This is a test for sending a message in secure mode. Please do not reply."

 $Error:=SMTP_QuickSend($ServerName;$MsgFrom;$MsgTo;$Subject;$Message;0;587;"a.user";"@!password@!")