4D Doc Center : NET

4D Internet Commands v14

NET_Ping


NET_Ping ( hostName ; text ; alive ; timeout ) -> 戻り値

引数	型	説明
hostName	文字	ホスト名またはIPアドレス
text	テキスト	Pingで送信するテキスト
alive	整数	1 = アクティブ, 0 = タイムアウト/レスポンスなし
timeout	整数	待ち秒数, 0 = IT_SetTimeOut値を使用
戻り値	整数	エラーコード

説明

NET_Ping コマンドは、IPアドレスで指定するマシンが現在アクティブかどうかを知るためのメカニズムを提供します。Pingを打たれたマシンが現在TCP/IPプロトコルを実行していて、二つのマシン間のネットワークが機能していれば、'レスポンスあり'ステータスが返されます。

NET_Ping はホスト名またはIPアドレスで指定されたマシンにPingを送信します。ネットワークでアクセス可能なマシンにIPアドレスでPingを送信できます。これにはエンドユーザのマシンが含まれます (ファイアウォールによる保護のためPingが妨げられることがあります) 。

hostName はPingの送信先ホスト名またはIPアドレスです。

text はPingで送信するテキストです。text 引数は、Pingコマンドが実行される際に送信されるTCPパケットのサイズにのみ影響を与えます。

alive にはPingされたマシンのステータスが返されます。1はマシンがアクティブであることを示します。0はマシンがアクティブでないか、レスポンスを受け取る前にタイムアウトしたことを示します。

timeout は、このコマンドがPing完了までに待ち受ける秒数を指定します。これはオプションの引数で省略可能です。デフォルト値は0で、この場合、IT_SetTimeOut コマンドで設定された値が使用されあます。

Note: この引数はWindows 95/98 および Millenniumでは考慮されません。