Socket.EndReceiveMessageFrom メソッド

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

Socket.EndReceiveMessageFrom メソッド

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

特定のエンドポイントからの、保留中の非同期読み込みを終了します。また、このメソッドは、EndReceiveFrom よりもパケットに関するより多くの情報を示します。

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

Visual Basic (宣言)

Public Function EndReceiveMessageFrom ( _
    asyncResult As IAsyncResult, _
    ByRef socketFlags As SocketFlags, _
    ByRef endPoint As EndPoint, _
    <OutAttribute> ByRef ipPacketInformation As
 IPPacketInformation _
) As Integer

Visual Basic (使用法)

Dim instance As Socket
Dim asyncResult As IAsyncResult
Dim socketFlags As SocketFlags
Dim endPoint As EndPoint
Dim ipPacketInformation As IPPacketInformation
Dim returnValue As Integer

returnValue = instance.EndReceiveMessageFrom(asyncResult, socketFlags, endPoint,
 ipPacketInformation)

C#

public int EndReceiveMessageFrom (
    IAsyncResult asyncResult,
    ref SocketFlags socketFlags,
    ref EndPoint endPoint,
    out IPPacketInformation ipPacketInformation
)

C++

public:
int EndReceiveMessageFrom (
    IAsyncResult^ asyncResult, 
    SocketFlags% socketFlags, 
    EndPoint^% endPoint, 
    [OutAttribute] IPPacketInformation% ipPacketInformation
)

J#

public int EndReceiveMessageFrom (
    IAsyncResult asyncResult, 
    /** @ref */ SocketFlags socketFlags, 
    /** @ref */ EndPoint endPoint, 
    /** @attribute OutAttribute() */ /** @ref */ IPPacketInformation ipPacketInformation
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

asyncResult

この非同期操作の状態情報およびユーザー定義データを格納する IAsyncResult。

socketFlags

受信パケットの SocketFlags 値のビットごとの組み合わせ。

endPoint

ソース EndPoint。

ipPacketInformation

受信パケットの IPAddress とインターフェイス。

戻り値
正常に完了した場合は、受信したバイト数。失敗した場合は、0 を返します。

例外

例外の種類	条件
ArgumentNullException	asyncResult is null 参照 (Visual Basic では Nothing) または endPoint が null 参照 (Visual Basic では Nothing) です。
ArgumentException	BeginReceiveMessageFrom メソッドへの呼び出しで asyncResult が返されませんでした。
InvalidOperationException	EndReceiveMessageFrom が、非同期の読み取りのために以前に呼び出されています。
SocketException	ソケットへのアクセスを試みているときにエラーが発生しました。詳細については「解説」を参照してください。
ObjectDisposedException	Socket は閉じられています。

解説

操作が完了していない場合、このメソッドは操作が完了するまでブロックします。

この操作を同期的に実行するには、ReceiveMessageFrom メソッドを使用します。

データグラムが、ユニキャスト、マルチキャスト、またはブロードキャストのどれを使用して送信されたのかを区別する必要がある場合は、ipPacketInformation を調べます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Socket クラス
Socket メンバ
System.Net.Sockets 名前空間