SMTP_Subject

4D v20

SMTP_Subject


SMTP_Subject ( smtp_ID ; subject {; deleteOption} ) -> 戻り値

引数	型	説明
smtp_ID	倍長整数	メッセージ参照
subject	テキスト	メッセージ件名
deleteOption	整数	0 = 置き換え (subjectが空でない場合), 1 = 置き換え, 2 = 削除
戻り値	整数	エラーコード

説明

SMTP_Subject コマンドは、smtp_IDで参照されるメッセージに件名を追加します。すでに件名がSMTP_Subject コマンドにより追加されている場合、以前の件名が新しい件名で上書きされます。

smtp_ID はSMTP_New コマンドで作成されるメッセージ参照です。

subject は、メッセージ内容の概略を表すテキスト値です

注:

デフォルトでは、メッセージの"Subject"ヘッダーはUTF-8でエンコードされています。これにより、送信された文字はほぼ全てのe-メールクライアントで正常に解釈されます。特定の文字コードを使用したい場合は、 SMTP_SetPrefs と SMTP_Charset コマンドを参照して下さい。
テキストにラインフィード (ascii=10)を含んでいてはいけません。含まれていると、それはヘッダ部の終わりかつボディ部の始まりを意味します。これに続くヘッダはボディ部に押し出され、サーバやクライアントで正しく解釈されません。ヘッダについての詳細は RFC#822 を参照してください。

deleteOption は"Subject"ヘッダを置き換えるか削除するか指定する整数値です:

0を指定すると、以前の値を置き換えて、"Subject" フィールドに新しい値を設定します。(空の文字列をsubjectに指定すると、以前のヘッダが保持されます。)
1を指定すると、以前の値を置き換えて、"Subject" フィールドに新しい値を設定します。(空の文字列をsubjectに指定すると、ヘッダが削除されます。)
2を指定すると、"Subject" フィールドに設定されていた値が削除され、ヘッダがメッセージから取り除かれます。

deleteOption はオプションの引数で、指定しない場合の値はデフォルトで0です。

例題

SMTP_Bodyコマンドの例題を参照してください。

参照

SMTP_Charset
SMTP_New
SMTP_SetPrefs