CAsyncSocket::SendTo

int SendTo ( const void ※ lpBuf, int nBufLen, UINT nHostPort, LPCTSTR lpszHostAddress = NULL、 int nFlags = 0 );

int SendTo ( const void ※ lpBuf, int nBufLen, const SOCKADDR ※ lpSockAddr, int nSockAddrLen, int nFlags = 0 );

戻り値

エラーが発生しない場合は、 SendToは送信した文字の合計数を返します。(このnBufLenによって示された数より少ないことに注意してください)。それ以外の場合、値がSOCKET_ERRORを返し、 GetLastErrorを呼び出して、特定のエラー コードを取得することができます。このメンバー関数を次のエラーを適用します。:

• WSANOTINITIALISED特価;成功AfxSocketInitがこの API を使用する前に行う必要があります。(&N)。
  
  
• WSAENETDOWN特価;Windows ソケットの実装、ネットワーク サブシステムが失敗したことが検出されました(&N)。
  
  
• WSAEACCES特価;要求されたアドレスはブロードキャスト アドレスですが、適切なフラグが設定されていません。(&N)。
  
  
• WSAEINPROGRESS特価;ブロックの Windows ソケット操作が進行中であります。(&N)。
  
  
• WSAEFAULT特価;LpBufまたはlpSockAddrパラメーター、ユーザー アドレス空間の一部ではないか、lpsockaddrが ( SOCKADDR構造体のサイズより小さい) 小さすぎます(&N)。
  
  
• WSAEINVAL特価;ホスト名が無効です。(&N)。
  
  
• WSAENETRESET特価;Windows ソケットの実装がそれを落としたため、接続をリセットする必要があります。(&N)。
  
  
• WSAENOBUFS特価;Windows ソケットの実装がバッファー デッドロックをレポートします。(&N)。
  
  
• WSAENOTCONN特価;ソケットではない (SOCK_STREAMのみ) を接続(&N)。
  
  
• 特価; wsaenotsock が返されるディスクリプターはソケットではないです。(&N)。
  
  
• WSAEOPNOTSUPP特価;MSG_OOBが指定されましたが、ソケットは、 SOCK_STREAMタイプのではないです。(&N)。
  
  
• WSAESHUTDOWN特価;ソケットをシャット ダウンされている;nHowを 1 または 2 に設定のシャット ダウンの呼び出し後にソケットにSendToを呼び出すことではないです。(&N)。
  
  
• WSAEWOULDBLOCK特価;ソケットがマークされている、非ブロッキングと要求された操作をブロックします。(&N)。
  
  
• WSAEMSGSIZE特価;ソケット タイプのSOCK_DGRAMであり、データグラム、Windows ソケットの実装によってサポートされている最大値より大きい(&N)。
  
  
• WSAECONNABORTED特価;タイムアウトやその他の障害のために、仮想回路が中止されました(&N)。
  
  
• WSAECONNRESET特価;リモート側で仮想回路がリセットされました(&N)。
  
  
• WSAEADDRNOTAVAIL特価;指定したアドレスは、ローカル マシンからではないです。(&N)。
  
  
• WSAEAFNOSUPPORT特価;アドレス指定の家族の中でこのソケットを使用できません。(&N)。
  
  
• WSAEDESTADDRREQ特価;宛先アドレスが必要です。(&N)。
  
  
• 「Wsaenetunreach」特価;このホストからこの時点でに到達することはできませんネットワーク(&N)。

パラメーター

lpBuf

送信するデータを含むバッファー。

nBufLen

LpBufバイトのデータの長さ。

nHostPort

ソケット アプリケーションを識別するポート。

lpszHostAddress

このオブジェクトが接続されているソケットのネットワーク アドレス:"ftp.microsoft.com、"ドット区切り番号「128.56.22.8」などのマシン名。

nFlags

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

• MSG_DONTROUTE特価;データ ルーティングをべきではないことを指定します。Windows ソケットの仕入先は、このフラグを無視するを選択できます。また、 SO_DONTROUTEオプションでの議論を参照してください 、Win32 SDK ドキュメントでWindows ソケットのプログラミングに関する考慮事項(&N)。
  
  
• MSG_OOB特価;帯域外のデータ (SOCK_STREAMのみ) を送信します。(&N)。

lpSockAddr

ターゲットのソケットのアドレスが含まれているSOCKADDR構造体へのポインター。

nSockAddrLen

LpSockAddrバイトのアドレスの長さ。

解説

データを特定の宛先に送信するにはこのメンバー関数を呼び出します。SendToは、データグラム ソケットまたはストリーム ソケットに使用され、ソケットに出力データを書き込むために使います。データグラム ソケットでは、 AfxSocketInitで記入するWSADATA構造内のiMaxUdpDg要素で指定した IP パケットの最大サイズは基になるサブネットを超えないように注意する必要があります。データが、基になるプロトコル アトミックには長すぎる場合は、 WSAEMSGSIZEエラーが返されますとデータを送信しません。

SendToが正常に完了、データが正常に配信されたことはないことを示しています。

LpSockAddrパラメーターによって識別される特定のソケットにデータグラムを送信する、 SOCK_DGRAMソケットをSendToでのみ使用することには。

(、 SOCK_DGRAM上のみ) ブロードキャストを送信するには、 lpSockAddrパラメーターでアドレス特別な IP アドレス (Windows ソケット ヘッダー ファイル WINSOCK を定義。 INADDR_BROADCASTを使用して構築する必要があります。目的のポート番号 H) と共に。または、 lpszHostAddressパラメーターがNULLの場合は、ソケットの放送のため構成です。それを断片化することができますが発生する、サイズを超過するブロードキャスト データグラムを一般的にお勧めではない (ヘッダーを除く)、データグラムのデータ部分が 512 バイトを超えないことを意味。

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

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