4D Doc Center : SMTP

4D Internet Commands v14

SMTP_References


SMTP_References ( smtp_ID ; references {; deleteOption} ) -> 戻り値

引数	型	説明
smtp_ID	倍長整数	メッセージ参照
references	テキスト	Reference Text
deleteOption	整数	0 = Replace (if references not empty), 1 = Replace, 2 = Delete
戻り値	整数	エラーコード

説明

SMTP_References コマンドは、メッセージが参照する追加の関連を指定します。

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

references は、参照を含む文字列です。この文字列のフォーマットについては、RFC#822を参照してください。

警告：テキストにラインフィード (ascii=10)を含んでいてはいけません。含まれていると、それはヘッダ部の終わりかつボディ部の始まりを意味します。これに続くヘッダはボディ部に押し出され、サーバやクライアントで正しく解釈されません。ヘッダについての詳細はRFC#822を参照してください。

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

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

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