IPStatus 列挙体とは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IPStatus 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

インターネットコントロールメッセージプロトコル (ICMP) エコーメッセージのコンピュータへの送信ステータスを報告します。

名前空間: System.Net.NetworkInformation
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Enumeration IPStatus

Visual Basic (使用法)

Dim instance As IPStatus

public enum IPStatus

C++

public enum class IPStatus

public enum IPStatus

JScript

public enum IPStatus

メンバ

	メンバ名	説明
	BadDestination	送信先の IP アドレスが ICMP エコー要求を受信できないため、または IP データグラムの終点アドレスフィールドに指定できない値であるために、ICMP エコー要求は失敗しました。たとえば、Send を呼び出し、IP アドレス "000.0.0.0" を指定すると、このステータスが返されます。
	BadHeader	ヘッダーが無効なため、ICMP エコー要求は失敗しました。
	BadOption	無効なオプションが含まれているため、ICMP エコー要求は失敗しました。
	BadRoute	送信元コンピュータと送信先コンピュータの間に有効な経路がないため、ICMP エコー要求は失敗しました。
	DestinationHostUnreachable	送信先コンピュータに到達できないため、ICMP エコー要求は失敗しました。
	DestinationNetworkUnreachable	送信先コンピュータが含まれるネットワークに到達できないため、ICMP エコー要求は失敗しました。
	DestinationPortUnreachable	送信先コンピュータのポートが利用できないため、ICMP エコー要求は失敗しました。
	DestinationProhibited	送信先コンピュータとの通信が管理上禁止されているため、ICMP エコー要求は失敗しました。
	DestinationProtocolUnreachable	ICMP エコーメッセージに指定された送信先コンピュータが、パケットのプロトコルをサポートしておらず到達できないため、ICMP エコー要求は失敗しました。
	DestinationScopeMismatch	ICMP エコーメッセージに指定された送信元アドレスと終点アドレスが同じスコープにないため、ICMP エコー要求は失敗しました。これは通常、送信元アドレスのスコープ外にあるインターフェイスを使用してパケットを転送するルーターが原因で発生します。あるアドレスがネットワーク上で有効な範囲は、アドレススコープ (リンクローカル、サイトローカル、グローバルスコープ) によって決まります。
	DestinationUnreachable	ICMP エコーメッセージに指定された送信先コンピュータに到達できないため、ICMP エコー要求は失敗しました。問題の詳細な原因は不明です。
	HardwareError	ハードウェアエラーのため、ICMP エコー要求は失敗しました。
	IcmpError	ICMP プロトコルエラーのため、ICMP エコー要求は失敗しました。
	NoResources	ネットワークリソースの不足のため、ICMP エコー要求は失敗しました。
	PacketTooBig	要求を格納しているパケットが、送信元と送信先の間にあるノード (ルーターまたはゲートウェイ) の MTU (Maximum Transmission Unit) よりも大きいため、ICMP エコー要求は失敗しました。MTU は、送信できるパケットの最大サイズを定義します。
	ParameterProblem	パケットヘッダーの処理中にノード (ルーターまたはゲートウェイ) で問題が発生したため、ICMP エコー要求は失敗しました。たとえば、ヘッダーに無効なフィールドデータや認識できないオプションが含まれている場合、このステータスになります。
	SourceQuench	パケットが破棄されたため、ICMP エコー要求は失敗しました。これは、送信元コンピュータの出力キューに十分なストレージ領域がない場合や、送信先に到達するパケットの量が多すぎて処理しきれない場合に発生します。
	Success	ICMP エコー要求は成功しました。ICMP エコー応答が受信されました。このステータスコードを取得した場合、他の PingReply プロパティに有効なデータが格納されています。
	TimedOut	割り当てられた時間内に ICMP エコー応答が受信されませんでした。各応答に割り当てられる既定の時間は 5 秒です。この値は、timeout パラメータを受け取る Send メソッドまたは SendAsync メソッドを使用して変更できます。
	TimeExceeded	有効期間 (TTL: time-to-live) の値が 0 に達し、転送を行うノード (ルーターまたはゲートウェイ) でパケットが破棄されたため、ICMP エコー要求は失敗しました。
	TtlExpired	有効期間 (TTL: time-to-live) の値が 0 に達し、転送を行うノード (ルーターまたはゲートウェイ) でパケットが破棄されたため、ICMP エコー要求は失敗しました。
	TtlReassemblyTimeExceeded	伝送用に分割されたパケットのフラグメントが、再アセンブルの割り当て時間内にすべて受信されなかったため、ICMP エコー要求は失敗しました。RFC 2460 (www.ietf.org を参照) では、すべてのパケットのフラグメントは、60 秒以内に受信される必要があると指定されています。
	Unknown	不明な理由のために ICMP エコー要求は失敗しました。
	UnrecognizedNextHeader	認識される値が Next Header フィールドに含まれていないため、ICMP エコー要求は失敗しました。Next Header フィールドは、拡張ヘッダーの種類 (存在する場合) や、TCP か UDP などの IP 層より上のプロトコルを示します。

解説

Ping クラスは、この列挙体の値を使用して、PingReply.Status プロパティを設定します。System.Net.NetworkInformation.Ping.Send メソッドまたは System.Net.NetworkInformation.Ping.SendAsync メソッドを呼び出して、ネットワーク経由でコンピュータに到達できるかどうかを確認すると、Ping クラスは PingReply オブジェクトを返します。

使用例

ICMP エコーメッセージを送信し、ステータスを確認するコード例を次に示します。

using System;
using System.Net;
using System.Net.NetworkInformation;
using System.Text;

namespace Examples.System.Net.NetworkInformation.PingTest
{
    public class PingExample
    {
        // args[0] can be an IPaddress or host name.
        public static void
 Main (string[] args)
        {
            Ping pingSender = new Ping ();
            PingOptions options = new PingOptions ();

            // Use the default Ttl value which is 128,
            // but change the fragmentation behavior.
            options.DontFragment = true;

            // Create a buffer of 32 bytes of data to be transmitted.
            string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
            byte[] buffer = Encoding.ASCII.GetBytes (data);
            int timeout = 120;
            PingReply reply = pingSender.Send (args[0], timeout, buffer, options);
            if (reply.Status == IPStatus.Success)
            {
                Console.WriteLine ("Address: {0}", reply.Address.ToString
 ());
                Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
                Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
                Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
                Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
            }
        }
    }
}