функция send (winsock2.h)

Функция отправки отправляет данные в подключенный сокет.

Синтаксис

int WSAAPI send(
  [in] SOCKET     s,
  [in] const char *buf,
  [in] int        len,
  [in] int        flags
);

Параметры

[in] s

Дескриптор, определяющий подключенный сокет.

[in] buf

Указатель на буфер, содержащий передаваемые данные.

[in] len

Длина (в байтах) данных в буфере, на которые указывает параметр buf .

[in] flags

Набор флагов, указывающих способ вызова. Этот параметр создается с помощью побитового оператора OR с любым из следующих значений.

Возвращаемое значение

Если ошибка не возникает, функция send возвращает общее количество отправленных байтов, которое может быть меньше числа, запрошенного для отправки в параметре len . В противном случае возвращается значение SOCKET_ERROR, а определенный код ошибки можно получить, вызвав WSAGetLastError.

Комментарии

Функция send используется для записи исходящих данных в подключенный сокет.

Для сокетов, ориентированных на сообщения (например, семейство адресов AF_INET или AF_INET6, тип SOCK_DGRAM и протокол IPPROTO_UDP), следует соблюдать осторожность, чтобы не превышать максимальный размер пакета базового поставщика. Максимальный размер пакета сообщений для поставщика можно получить, вызвав метод getsockopt с параметром optname , равным SO_MAX_MSG_SIZE для получения значения параметра socket. Если данные слишком длинны для атомарной передачи через базовый протокол, возвращается ошибка WSAEMSGSIZE и данные не передаются.

Успешное завершение функции отправки не означает, что данные были успешно доставлены и получены получателю. Эта функция только указывает, что данные были успешно отправлены.

Если в транспортной системе нет буферного пространства для хранения передаваемых данных, отправка будет блокироваться, если сокет не был помещен в неблокировочный режим. В неблокированных сокетах, ориентированных на поток, число записанных байтов может составлять от 1 до требуемой длины в зависимости от доступности буфера как на клиентском, так и на серверном компьютерах. Функции select, WSAsyncSelect или WSAEventSelect можно использовать для определения возможности отправки дополнительных данных.

Вызов отправки с параметром len , равным нулю, допустим и будет рассматриваться реализациями как успешная. В таких случаях send возвращает ноль в качестве допустимого значения. Для сокетов, ориентированных на сообщения, отправляется транспортная датаграмма нулевой длины.

Параметр flags можно использовать для влияния на поведение функции за пределами параметров, указанных для связанного сокета. Семантика функции отправки определяется любыми параметрами, ранее заданными в сокете, указанном в параметре s , и параметром flags, переданным функции отправки .

Порядок вызовов, выполненных для отправки , также является порядком передачи буферов на транспортный уровень. Отправка не должна вызываться в одном потокоориентированном сокете одновременно из разных потоков, так как некоторые поставщики Winsock могут разделить большой запрос на отправку на несколько передач, что может привести к непреднамеренное чередование данных из нескольких одновременных запросов на отправку в одном и том же сокете, ориентированном на поток.

Пример кода

#ifndef UNICODE
#define UNICODE
#endif

#define WIN32_LEAN_AND_MEAN

#include <winsock2.h>
#include <Ws2tcpip.h>
#include <stdio.h>

// Link with ws2_32.lib
#pragma comment(lib, "Ws2_32.lib")

#define DEFAULT_BUFLEN 512
#define DEFAULT_PORT 27015

int main() {

    //----------------------
    // Declare and initialize variables.
    int iResult;
    WSADATA wsaData;

    SOCKET ConnectSocket = INVALID_SOCKET;
    struct sockaddr_in clientService; 

    int recvbuflen = DEFAULT_BUFLEN;
    char *sendbuf = "Client: sending data test";
    char recvbuf[DEFAULT_BUFLEN] = "";

    //----------------------
    // Initialize Winsock
    iResult = WSAStartup(MAKEWORD(2,2), &wsaData);
    if (iResult != NO_ERROR) {
        wprintf(L"WSAStartup failed with error: %d\n", iResult);
        return 1;
    }

    //----------------------
    // Create a SOCKET for connecting to server
    ConnectSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (ConnectSocket == INVALID_SOCKET) {
        wprintf(L"socket failed with error: %ld\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    //----------------------
    // The sockaddr_in structure specifies the address family,
    // IP address, and port of the server to be connected to.
    clientService.sin_family = AF_INET;
    clientService.sin_addr.s_addr = inet_addr( "127.0.0.1" );
    clientService.sin_port = htons( DEFAULT_PORT );

    //----------------------
    // Connect to server.
    iResult = connect( ConnectSocket, (SOCKADDR*) &clientService, sizeof(clientService) );
    if (iResult == SOCKET_ERROR) {
        wprintf(L"connect failed with error: %d\n", WSAGetLastError() );
        closesocket(ConnectSocket);
        WSACleanup();
        return 1;
  }

    //----------------------
    // Send an initial buffer
    iResult = send( ConnectSocket, sendbuf, (int)strlen(sendbuf), 0 );
    if (iResult == SOCKET_ERROR) {
        wprintf(L"send failed with error: %d\n", WSAGetLastError());
        closesocket(ConnectSocket);
        WSACleanup();
        return 1;
    }

    printf("Bytes Sent: %d\n", iResult);

    // shutdown the connection since no more data will be sent
    iResult = shutdown(ConnectSocket, SD_SEND);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"shutdown failed with error: %d\n", WSAGetLastError());
        closesocket(ConnectSocket);
        WSACleanup();
        return 1;
    }

    // Receive until the peer closes the connection
    do {

        iResult = recv(ConnectSocket, recvbuf, recvbuflen, 0);
        if ( iResult > 0 )
            wprintf(L"Bytes received: %d\n", iResult);
        else if ( iResult == 0 )
            wprintf(L"Connection closed\n");
        else
            wprintf(L"recv failed with error: %d\n", WSAGetLastError());

    } while( iResult > 0 );


    // close the socket
    iResult = closesocket(ConnectSocket);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"close failed with error: %d\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    WSACleanup();
    return 0;
}

Пример кода

Примечания для сокетов IrDA

• Файл заголовка Af_irda.h должен быть явно включен.

Windows 8.1 и Windows Server 2012 R2. Эта функция поддерживается для приложений Магазина Windows на Windows 8.1, Windows Server 2012 R2 и более поздних версиях.

Требования

См. также раздел

начало работы с Winsock

WSAsyncSelect

WSAEventSelect

Функции Winsock

Справочник по Winsock

Recv

recvfrom

select

Sendto

Сокета