NET_Ping

4D v20 R7

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 コマンドで設定された値が使用されます。

注: Windows では、NET_Ping コマンドを使用するためには4D が管理者権限で起動している必要がある場合があります。管理者権限で起動していない場合、プロシージャーは失敗し、-10013 エラーコード("許可に失敗しました")が返される可能性があります。

参照