SMTP_Charset

4D v19

SMTP_Charset


SMTP_Charset ( encodeHeaders ; bodyCharset ) -> 戻り値

引数	型	説明
encodeHeaders	整数	-1 = 現在の設定を使用, 0 = デフォルト設定を使用, 1 = 指定された文字セットを使用して変換
bodyCharset	整数	-1 = 現在の設定を使用, 0 = デフォルト設定を使用, 1 = 指定された文字セットを使用して変換
戻り値	整数	エラーコード

説明

SMTP_Charset コマンドは、SMTP_QuickSend や SMTP_Send コマンドでメッセージを送信する際に、拡張文字を含むメッセージをサポートするために自動で変換処理が行われるよう設定します。

SMTP_Charset コマンドは、まずメッセージヘッダー、添付ファイル名とボディの変換にSMTP_SetPrefs の charset&Encoding 引数を適用するかを指定し、次に拡張文字を含むヘッダーおよび添付ファイル名をRFC#1342で定義された“=?ISO-8859-1?Q?Test=E9?= …”のシンタックスでエンコードするかを指定します。このコマンドはインタープロセススコープを持っていて、このコマンド実行後はあらゆる4Dプロセスで SMTP_QuickSend と SMTP_Sendを使用して送信されるメッセージに影響します。

このコマンドは件名やメールアドレスに拡張文字が含まれる場合に有効です (たとえば“=?ISO-8859-1?Q?Test=E9?= <test@n.net >”のようなアドレスのエンコーディング)。

メッセージヘッダーに応じて、エンコーディング( SMTP_SetPrefs bodyType引数によって変化、それ以外は常にBase64(だだし題名ヘッダを除く))は以下のように管理されます:

メッセージヘッダートおよび添付ファイル名はRFC 1342に従って、次のようにエンコードされます:
From, To, CC, Bcc, Sender, ReplyTo, InReplyTo:
- 山括弧 (“<”, “>”) に挟まれたテキストはメールアドレスとして認識され、エンコードされません。
- SPC < > ( ) @ , ; : " / ? . = などの特別文字や区切り文字はエンコードされません。
- 特別文字や区切り文字に挟まれた文字列は、拡張文字が含まれていればbase64でエンコードされます。
- アドレスの例:
  someone@somewhereはエンコードされません
  Michele <michele@somewhere>, Micheleのみエンコードされます
他のヘッダーはエンコードされません。

encodeHeadersは、メッセージ送信時のヘッダの変換処理の方法とエンコーディングを指定する引数です。デフォルト値は0です。

-1: 現在の設定を使用
0: デフォルト: 題名は "UTF-8"、その他のフィールドは "ISO-8859-1"
1: SMTP_SetPrefs の charset&Encoding パラメーターで指定された文字セットをヘッダーと添付ファイル名に使用します。

注: “X_…”で始まる拡張ヘッダはUS ASCIIのみで記述しなければなりません。

bodyCharset は、メッセージを送信する際のメッセージボディの文字セットとエンコーディングを指定する引数です。デフォルト値は0です。

-1: 現在の設定を使用
0: デフォルト: UTF-8 base64
1: SMTP_SetPrefs の charset&Encoding パラメーターで指定された文字セットとエンコーディングを使用します。

注: 現在使用されるほとんどのシステムおよびアプリケーションで適切である、デフォルト設定の使用を推奨します。

例題

以下の例では、題名と本文はUTF-8文字セットを使用して変換され、題名は以下のRFC 1342シンタックスを使用してエンコードされます:

 SMTP_SetPrefs(1;1;0)

 $err:=SMTP_Charset(1;1)

 $err:=SMTP_QuickSend("mymail.com";"myaddress";"destination";"the Euro €";"the Euro symbol is €")

参照

POP3_Charset
SMTP_SetPrefs