CAsyncSocket::Receive

仮想 int 受信 ( void ※ lpBuf, int nBufLen, int nFlags = 0 );

戻り値

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

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

パラメーター

lpBuf

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

nBufLen

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

nFlags

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

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

解説

ソケットからデータを受信するにはこのメンバー関数を呼び出します。この関数は接続されているストリームまたはデータグラムソケットを使用し、受信データを読み取るために使用されて。

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

データグラムソケットでは、指定されたバッファーのサイズまで、最初のキューに格納されたデータグラムからデータが抽出されます。データグラムが指定されたバッファーよりも大きい場合、超過データは失われます、データグラムの最初の部分でバッファーがいっぱいです、受信値がSOCKET_ERROR WSAEMSGSIZEに、エラーコードを返します。ソケットに利用できる受信データがない場合は、値がSOCKET_ERROR WSAEWOULDBLOCKを設定、エラーコードが返されます。多くのデータが到着したときを判断するには、 OnReceiveコールバック関数を使用できます。

ソケットSOCK_STREAMタイプのリモート側が接続を正常にシャットダウンしている場合は、0 バイト受信受信がすぐに完了します。接続がリセットされた場合は、受信エラー WSAECONNRESETで失敗します。

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

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

Index