CAsyncSocket::SendTo

Int SendTo ( константа порожнечу * lpBuf, int nBufLen, UINT nHostPort, LPCTSTR lpszHostAddress = NULL, int nFlags = 0 );

Int SendTo ( константа порожнечу * lpBuf, int nBufLen, константа SOCKADDR * lpSockAddr, int nSockAddrLen, int nFlags = 0 );

Значення, яке повертається

Якщо помилки немає, SendTo повертає загальну кількість символів, що надсилаються. (Зауважимо, що це може бути менше, ніж номер, зазначений на nBufLen.) Інакше, повертається значення з SOCKET_ERROR , і міститься код помилки можуть бути отримані за номером GetLastError. Такі помилки застосовуються до цієї функції-члени:

WSA&NOTINITIALISEDnbsp; Успішних AfxSocketInit має бути ранішим за допомогою цього API.
WSAE&NETDOWNnbsp; Реалізація Windows Sockets виявлено, що мережної підсистеми не вдалося.
WSAEACCES Запитана адреса є адресою, трансляції, але не був встановлений у відповідному прапор.
WSAEI&NPROGRESSnbsp; Виконується операція блокування Windows Sockets.
WSAEFAULT LpBuf або lpSockAddr параметрів не є частиною адресного простору користувача або lpSockAddr аргументом є занадто малий (менше, ніж розмір SOCKADDR структури).
WSAEI&NVALnbsp; Неприпустиме ім'я хоста.
WSAE&NETRESETnbsp; Підключення потрібно скинути, тому що реалізація Windows Sockets впав.
WSAE&NOBUFSnbsp; Реалізація Windows Sockets повідомляє буфер глухий кут.
WSAE&NOTCONNnbsp; Сокет є не підключено (SOCK_STREAM тільки).
WSAE&NOTSOCKnbsp; На дескриптор не є панельку.
WSAEOP&NOTSUPPnbsp;MSG_OOB було зазначено, але сокет не типу SOCK_STREAM.
WSAESHUTDOW&Nnbsp; Сокет був закритий; Це не можливо, щоб подзвонити SendTo на сокеті, після завершення роботи був викликаний з nHow значення 1 або 2.
WSAEWOULDBLOCK Сокет позначений як nonblocking і операцію буде блокувати.
WSAEMSGSIZE Сокет типу SOCK_DGRAM, і на дейтаграм перевищує максимальну підтримку реалізація Windows Sockets.
WSAECO&NNABORTEDnbsp; Віртуальний канал було припинено через вичерпання часу очікування або інші несправності.
WSAECO&NNRESETnbsp; Віртуальний канал був скинутий на віддаленій стороні.
WSAEADDR&NOTAVAILnbsp; Указана адреса не доступна з локального комп'ютера.
WSAEAF&NOSUPPORTnbsp; Адреси у вказаному сім'ї неможливо використати для цього socket.
WSAEDESTADDRREQ Адреса призначення.
WSAE&NETUNREACHnbsp; Мережі не можна дістатися з цього вузла, на цей час.

Параметри

lpBuf

Буфер, який містить дані передаються.

nBufLen

Довжина дані в lpBuf в байт.

nHostPort

Порт, визначення socket застосування.

lpszHostAddress

Мережна адреса сокет, до якого підключено цей об'єкт: ім'я машини, такі, як "ftp.microsoft.com", або пунктирною число, наприклад "128.56.22.8".

nFlags

Визначає спосіб, в яких здійснюється виклик. Семантика ця функція визначається налаштувань socket і параметр nFlags . Останній будується шляхом об'єднання будь-яке з таких значень з C++ або оператором:

MSG_DO&NTROUTEnbsp; Вказує, що дані слід не підлягають маршрутизації. Windows Sockets постачальників можете ігнорувати цей прапор; Див. також обговорення опцію SO_DONTROUTE в Windows розетки програмування міркувань в документації Win32 SDK.
MSG_OOB Надіслати дані-група (SOCK_STREAM тільки).

lpSockAddr

Вказівник на SOCKADDR структуру, яка містить адресу цільового socket.

nSockAddrLen

Довжина адреси в lpSockAddr в байт.

Зауваження

Телефонуйте цієї функції-члена для надсилання даних до певного місця призначення. SendTo використовується на дейтаграм або потоку розетки і використовується для запису даних на сокеті. Для дейтаграм розетки повинні бути прийняті перевищувати максимальної IP розмір пакета з базової підмереж, який дається iMaxUdpDg елементом у структурі WSADATA заповнювати за AfxSocketInit. Якщо дані не atomically проходити через основний протокол, помилка WSAEMSGSIZE , а не передачі.

Зверніть увагу, що успішне завершення SendTo не означає, що дані було успішно доставлене.

SendTo використовується лише на сокеті SOCK_DGRAM відправити дейтаграм конкретні socket визначені lpSockAddr параметр.

Щоб надіслати трансляції (на на SOCK_DGRAM тільки), адреса в параметрі lpSockAddr повинні бути побудовані за допомогою спеціальних IP-адреса INADDR_BROADCAST (визначається у файл заголовка Windows Sockets WINSOCK.H) разом з номером призначене порту. Або, якщо параметр lpszHostAddress є NULL, сокет настроєно для трансляції. Це зазвичай inadvisable для трансляції дейтаграм перевищує розмір, який може відбуватися фрагментації, який означає, що частину даних дейтаграм, (за винятком заголовків) не повинен перевищувати 512 байт.

Огляд CAsyncSocket |nbsp; Члени класу | Ієрархічна діаграма

Дивіться також CAsyncSocket::Create, CAsyncSocket::Receive, CAsyncSocket::ReceiveFrom, CAsyncSocket::Send

Index