引数フォーマット

4D Internet Commands v16

引数フォーマット

ここでは、このマニュアルを通して使用される主要なパラメーターの意味やフォーマットを説明します。

パラメーター	型		説明
hostName	文字列	→	ホスト名 (例: "www.companyname.com")
			IP アドレス (例: "204.118.90.2")
ip_LongInt	倍長整数	→	IPアドレスの倍長整数参照
mailAddress	テキスト	→	例: "jsmith@4d.com"
addressList	テキスト	→	例: "jsmith@4d.com, jdupont@4d.fr" または
			"jsmith@4d.com"+Char(13)+"jdupont@4d.fr"
localPath	テキスト	→	- ドキュメント
			Mac: "My Hard Drive:4DDB:SalesDB:Report"
			Win: "C:\MyDrive\4DDB\SalesDB\Report.txt"
			- ディレクトリ
			Mac: "My Hard Drive:CoolStuff:"
			Win: "C:\MyDrive\CoolStuff\"
hostPath	テキスト	→	- ドキュメント
			"/usr/jsmith/reports/salesreport.txt"
			- ディレクトリ
			"/usr/jsmith/reports/"
tcp_ID	倍長整数	→	開かれたTCPセッション参照
smtp_ID	倍長整数	→	新規メールメッセージ参照
pop3_ID	倍長整数	→	開かれたPOP3セッション参照
imap_ID	倍長整数	→	開かれたIMAP接続参照
ftp_ID	倍長整数	→	開かれたFTPセッション参照
udp_ID	倍長整数	→	UDPソケット参照

戻り値	整数	←	エラーコード

hostName

hostName は"dns.4d.com" や "204.118.90.2"のようなホスト名またはIPアドレスです。ホスト名はドメイン名システムを使用して解決されます。プライマリおよびセカンダリDNSは通常OSのコントロールパネルを使用して設定されます。hostName を引数として受け取る4DICのコマンドはホスト名、あるいはIPアドレス形式いずれのフォーマットも受け入れますが、サーバーのIPアドレスは変更されることがあるため、ホスト名形式を使用することが推奨されます。

ip_LongInt

ホスト名はドメイン名システムを使用してIPアドレスに変換されます。IPアドレスは文字であらわされますが、計算を行うことで倍長整数に変換することができます。NET_NameToAddr や NET_AddrToName などのコマンドを使用すればこの変換処理を実行させることができます。この倍長整数値をこのマニュアルでは ip_LongInt という名前で参照します。倍長整数値は直接的にTCP接続を行う特別な状況下でのみ利用されます。またホスト名の代わりに解決済みの倍長整数値を使用することで、ディスクスペースを節約できます。しかしIPV6との互換性のため、倍長整数値は使用すべきではありません。

mailAddress

MailAddress は "user_name@domain_name" という形式のメールアドレスです。このドキュメントでは mailAddress はひとつのメールアドレスを表します。メールアドレスのリストは addressList で参照します。引数が mailAddress のみである場合、ひとつのメールアドレスしか引数として渡せないことを意味します。mailAddress のフォーマットはユーザー名とドメイン名両方を含んでいなければなりません:

"Felix Unger" <felix@pristine.com>
oscar@slobs.com (Oscar Madison)

addressList

addressList は一つ以上のメールアドレスを含みます。各メールアドレスはカンマまたはキャリッジリターンで区切ります。以下の例題はいずれも有効なアドレスリストを生成します:

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

 $AddressList:="jsmith@4d.com,scott@4d.com,marcel@4d.fr"

 For($i;1;Size of array(aAddresses))

    $AddressList:=$AddressList+aAddresses{$i}+"\r"

 End for

localPath

localPath はユーザーマシン上(MacまたはWindows)におけるファイルやディレクトリの場所です。

MacOSではコロンをディレクトリ区切り文字として使用します。たとえば"My Hard Drive"ハードディスク内の"Reports"フォルダーにある"My Report.txt"は"My Hard Drive:Reports:My Report.txt"というパス名であらわすことができます。MacOSにおいて、ディレクトリのパスはコロンで終了しなければなりません。たとえば新しいレポートを同じフォルダーに保存するには"My Hard Drive:Reports:"と指定します。ファイルとディレクトリいずれを参照するかは、コマンドが呼び出されるコンテキストに基づきます。

Windowsでも同様のルールを用いますが、ディレクトリ区切り文字にはバックスラッシュ (\　日本語フォント環境では円マークになることがあります) を使用します。

注: 4DICのFTPプロトコルでは、扱う事ができるファイル名に限度があります。詳細な情報に関しては、ファイル転送 - 概要の章を参照して下さい。

hostPath

hostPath はUnix OSで実行されているコンピューター上のファイルやディレクトリを示す場所です。Unix環境ではディレクトリ区切り文字としてスラッシュ (/) を使用します。たとえば"4D"ディレクトリ中の"reports"ディレクトリの中の"report.txt"ファイルは"/4D/reports /report.txt"で示すことができます。ディレクトリパス名は "/" で終了しなければなりません。パス名先頭の"/"はボリュームのルートを表します。

注: 4DICのFTPプロトコルでは、扱う事ができるファイル名に限度があります。詳細な情報に関しては、ファイル転送 - 概要の章を参照して下さい。

smtp_ID, pop3_ID, imap_ID, ftp_ID, tcp_ID

4D Internet Commandsは多くのコマンドで"ID"を引数にとります。各通信機能のコマンドセットは独自のセッションを確立し、それは"ID"で参照できます。セッションを開くコマンドに続く一連のコマンドはこのIDを使用してセッションを特定します。

各通信コマンド (SMTP, POP3, IMAP, FTP, TCP, UDP) で取得できるIDを他の通信コマンドに渡すことはできません。しかしPOP3, IMAP, FTP接続のIDは低レベルのTCPコマンドに渡すことができます。詳細は低レベルルーチン - 概要を参照してください。

セッション参照	セッションを開く	セッションを閉じる
tcp_ID	TCP_Open または TCP_Listen	TCP_Close
smtp_ID	SMTP_New	SMTP_Clear
pop3_ID	POP3_Login	POP3_Logout または POP3_VerifyID
imap_ID	IMAP_Login	IMAP_Logout または IMAP_VerifyID
ftp_ID	FTP_Login	FTP_Logout または FTP_VerifyID
udp_ID	UDP_New	UDP_Delete

戻り値

すべての4D Internet Commands (IT_ErrorText と IT_Versionを除く) は関数の結果として整数値を返します。この整数値には4Dデータベースに通知すべき関数の結果としてエラーコードが含まれます。コマンドの実行に成功すると、0が返されます。非0が返された場合、エラーが発生したことを意味します。4D Internet CommandsのエラーコードについてはAppendix C, 4D Internet Commandsエラーコードを参照してください。