CAsyncSocket::ReceiveFrom

int ReceiveFrom ( void ※ lpBuf, int nBufLen, CStringamp; rSocketAddress, UINT ＆ rSocketPort, int nFlags = 0 );(&A)

int ReceiveFrom ( void ※ lpBuf, int nBufLen, SOCKADDR ※ lpSockAddr, int ※ lpSockAddrLen, int nFlags = 0 );

戻り値

エラーが発生しない場合、 ReceiveFromは受信したバイト数を返します。接続が閉じられている場合は、0 を返します。それ以外の場合、値がSOCKET_ERRORを返し、 GetLastErrorを呼び出して、特定のエラーコードを取得することができます。このメンバー関数を次のエラーを適用します。:

WSANOTINITIALISED特価;成功AfxSocketInitがこの API を使用する前に行う必要があります。(&N)。
WSAENETDOWN特価;Windows ソケットの実装、ネットワークサブシステムが失敗したことが検出されました(&N)。
WSAEFAULT特価;LpSockAddrLen引数が無効です: lpSockAddrバッファーは、ピアのアドレスに対応するには小さすぎるだった(&N)。
WSAEINPROGRESS特価;ブロックの Windows ソケット操作が進行中であります。(&N)。
WSAEINVAL特価;ソケットバインドにバインドされていません。(&N)。
WSAENOTCONN特価;ソケットではない (SOCK_STREAMのみ) を接続(&N)。
特価; wsaenotsock が返されるディスクリプターはソケットではないです。(&N)。
WSAEOPNOTSUPP特価;MSG_OOBが指定されましたが、ソケットは、 SOCK_STREAMタイプのではないです。(&N)。
WSAESHUTDOWN特価;ソケットをシャットダウンされている;nHowを 0 または 2 に設定のシャットダウンの呼び出し後にソケットReceiveFromを呼び出すことではないです。(&N)。
WSAEWOULDBLOCK特価;ソケットがマークされている、非ブロッキング、 ReceiveFrom操作をブロックします。(&N)。
WSAEMSGSIZE特価;データグラムを指定されたバッファーに収まるように大きすぎるとが切り捨てられました(&N)。
WSAECONNABORTED特価;タイムアウトやその他の障害のために、仮想回路が中止されました(&N)。
WSAECONNRESET特価;リモート側で仮想回路がリセットされました(&N)。

パラメーター

lpBuf

着信データ用のバッファー。

nBufLen

LpBuf (バイト単位) の長さ。

rSocketAddress

点線の番号 IP アドレスを受け取るCStringオブジェクトへの参照。

rSocketPort

ポートを格納するUINTへの参照。

lpSockAddr

返却時にソースアドレスを保持を格納している SOCKADDR構造体へのポインター。

lpSockAddrLen

LpSockAddrバイトのソースアドレスの長さへのポインター。

nFlags

呼び出しが行われる方法を指定します。この関数の意味は、ソケットオプションとパラメーター nFlagsによって決まります。後者は C++または演算子を使って次の値のいずれかを組み合わせることで構築します。:

MSG_PEEK特価;着信データをピークします。データをバッファーにコピーされますが、入力キューから削除されません。(&N)。
MSG_OOB特価;帯域外のデータの処理 (を参照してください、Win32 sdk のこのトピックについてのWindows ソケットプログラミングの考慮事項)(&N)。

解説

データグラムを受信し、 SOCKADDR構造体またはrSocketAddressのソースアドレスを格納するにはこのメンバー関数を呼び出します。この関数を使用して、(おそらく) ソケットで受信データを読み取るし、データを送信するために使用したアドレスを取得するには。

SOCK_STREAMタイプのソケットの場合、できるだけ多くの情報は、指定されたバッファーのサイズまで使用可能なが返されます。ソケット帯域外のデータ (ソケットオプションSO_OOBINLINE) の行で受信の構成されているし、帯域外のデータは読み取りではない場合は、帯域外のデータのみが返されます。アプリケーションは、 IOCtlSIOCATMARKオプションまたはOnOutOfBandDataがより帯域外のデータを読み取ることが残っているかどうかを判断する際にできます。LpSockAddrおよびlpSockAddrLenパラメーター SOCK_STREAMのソケットの場合は無視されます。。

データグラムソケットでは、指定されたバッファーのサイズまで、最初のキューに格納されたデータグラムからデータが抽出されます。データグラムが指定されたバッファーよりも大きい場合は、メッセージの最初の部分でバッファーがいっぱいです、超過データは失われます、 ReceiveFrom値がSOCKET_ERROR WSAEMSGSIZEに、エラーコードを返します。

LpSockAddrが 0 以外の値、型SOCK_DGRAMのソケットである場合は、データを送信、ソケットのネットワークアドレスに対応するSOCKADDR構造体にコピーされます。LpSockAddrLenが指す値はこの構造体のサイズに初期化され、roi が格納されているアドレスの実際のサイズを示すために変更されます。ソケットに利用できる受信データがない場合は、 ReceiveFromの呼び出しをソケットにデータを待機するブロック。この例では、値がSOCKET_ERROR WSAEWOULDBLOCKを設定、エラーコードが返されます。OnReceiveコールバックを使用してより多くのデータが到着したときを確認できます。

ソケットSOCK_STREAMタイプのリモート側が接続を正常にシャットダウンしている場合、 ReceiveFromすぐに 0 バイト受信を完了します。

CAsyncSocket 概要|nbsp;クラスメンバー |階層図(&N)

参照特価;CAsyncSocket::AsyncSelect、 CAsyncSocket::Create、 CAsyncSocket::Receive、 :send(&N)

Index