Função send (winsock2.h)

A função send envia dados em um soquete conectado.

Sintaxe

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

Parâmetros

[in] s

Um descritor que identifica um soquete conectado.

[in] buf

Um ponteiro para um buffer que contém os dados a serem transmitidos.

[in] len

O comprimento, em bytes, dos dados no buffer apontados pelo parâmetro buf .

[in] flags

Um conjunto de sinalizadores que especificam a maneira como a chamada é feita. Esse parâmetro é construído usando o operador OR bit a bit com qualquer um dos valores a seguir.

Retornar valor

Se nenhum erro ocorrer, send retornará o número total de bytes enviados, que pode ser menor do que o número solicitado para ser enviado no parâmetro len . Caso contrário, um valor de SOCKET_ERROR é retornado e um código de erro específico pode ser recuperado chamando WSAGetLastError.

Comentários

A função send é usada para gravar dados de saída em um soquete conectado.

Para soquetes orientados a mensagens (família de endereços de AF_INET ou AF_INET6, tipo de SOCK_DGRAM e protocolo de IPPROTO_UDP, por exemplo), deve-se tomar cuidado para não exceder o tamanho máximo do pacote do provedor subjacente. O tamanho máximo do pacote de mensagem para um provedor pode ser obtido chamando getsockopt com o parâmetro optname definido como SO_MAX_MSG_SIZE para recuperar o valor da opção de soquete. Se os dados forem muito longos para passar atomicamente pelo protocolo subjacente, o erro WSAEMSGSIZE será retornado e nenhum dado será transmitido.

A conclusão bem-sucedida de uma função de envio não indica que os dados foram entregues e recebidos com êxito ao destinatário. Essa função indica apenas que os dados foram enviados com êxito.

Se nenhum espaço de buffer estiver disponível no sistema de transporte para manter os dados a serem transmitidos, o envio será bloqueado, a menos que o soquete tenha sido colocado no modo sem bloqueio. Em soquetes orientados ao fluxo sem bloqueio, o número de bytes gravados pode ser entre 1 e o comprimento solicitado, dependendo da disponibilidade do buffer nos computadores cliente e servidor. As funções select, WSAAsyncSelect ou WSAEventSelect podem ser usadas para determinar quando é possível enviar mais dados.

Chamar enviar com um parâmetro len de zero é permitido e será tratado por implementações como bem-sucedido. Nesses casos, send retornará zero como um valor válido. Para soquetes orientados a mensagens, um datagrama de transporte de comprimento zero é enviado.

O parâmetro flags pode ser usado para influenciar o comportamento da função além das opções especificadas para o soquete associado. A semântica da função send é determinada por todas as opções definidas anteriormente no soquete especificado no parâmetro s e pelo parâmetro flags passado para a função send .

A ordem das chamadas feitas para enviar também é a ordem na qual os buffers são transmitidos para a camada de transporte. send não deve ser chamado no mesmo soquete orientado a fluxo simultaneamente de threads diferentes, pois alguns provedores winsock podem dividir uma solicitação de envio grande em várias transmissões, e isso pode levar a intercalação de dados não intencionais de várias solicitações de envio simultâneas no mesmo soquete orientado a fluxo.

Código de exemplo

#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;
}

Código de exemplo

Notas sobre soquetes IrDA

• O arquivo de cabeçalho Af_irda.h deve ser incluído explicitamente.

Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.

Requisitos

Confira também

Introdução com Winsock

WSAAsyncSelect

Wsaeventselect

Funções Winsock

Referência de Winsock

Recv

Recvfrom

select

Sendto

socket