send, fonction (winsock2.h)

La fonction d’envoi envoie des données sur un socket connecté.

Syntaxe

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

Paramètres

[in] s

Descripteur identifiant un socket connecté.

[in] buf

Pointeur vers une mémoire tampon contenant les données à transmettre.

[in] len

Longueur, en octets, des données dans la mémoire tampon pointées par le paramètre buf .

[in] flags

Ensemble d’indicateurs qui spécifient la façon dont l’appel est effectué. Ce paramètre est construit à l’aide de l’opérateur OR au niveau du bit avec l’une des valeurs suivantes.

Valeur retournée

Si aucune erreur ne se produit, send retourne le nombre total d’octets envoyés, qui peut être inférieur au nombre demandé à envoyer dans le paramètre len . Sinon, une valeur de SOCKET_ERROR est retournée et un code d’erreur spécifique peut être récupéré en appelant WSAGetLastError.

Remarques

La fonction d’envoi est utilisée pour écrire des données sortantes sur un socket connecté.

Pour les sockets orientés message (famille d’adresses de AF_INET ou de AF_INET6, type de SOCK_DGRAM et protocole d’IPPROTO_UDP, par exemple), veillez à ne pas dépasser la taille de paquet maximale du fournisseur sous-jacent. La taille maximale du paquet de messages d’un fournisseur peut être obtenue en appelant getsockopt avec le paramètre optname défini sur SO_MAX_MSG_SIZE pour récupérer la valeur de l’option de socket. Si les données sont trop longues pour passer de manière atomique via le protocole sous-jacent, l’erreur WSAEMSGSIZE est retournée et aucune donnée n’est transmise.

La réussite d’une fonction d’envoi n’indique pas que les données ont été correctement remises et reçues au destinataire. Cette fonction indique uniquement que les données ont été correctement envoyées.

Si aucun espace tampon n’est disponible dans le système de transport pour contenir les données à transmettre, l’envoi est bloqué, sauf si le socket a été placé en mode non bloquant. Sur les sockets orientés flux non bloquants, le nombre d’octets écrits peut être compris entre 1 et la longueur demandée, en fonction de la disponibilité de la mémoire tampon sur les ordinateurs clients et serveurs. Les fonctions select, WSAAsyncSelect ou WSAEventSelect peuvent être utilisées pour déterminer quand il est possible d’envoyer plus de données.

L’appel de l’envoi avec un paramètre len de zéro est autorisé et sera traité par les implémentations comme réussie. Dans ce cas, l’envoi retourne zéro comme valeur valide. Pour les sockets orientés message, un datagramme de transport de longueur nulle est envoyé.

Le paramètre flags peut être utilisé pour influencer le comportement de la fonction au-delà des options spécifiées pour le socket associé. La sémantique de la fonction d’envoi est déterminée par toutes les options précédemment définies sur le socket spécifié dans le paramètre s et le paramètre flags passé à la fonction d’envoi .

L’ordre des appels à envoyer est également l’ordre dans lequel les mémoires tampons sont transmises à la couche de transport. l’envoi ne doit pas être appelé simultanément sur le même socket orienté flux à partir de différents threads, car certains fournisseurs Winsock peuvent fractionner une demande d’envoi volumineuse en plusieurs transmissions, ce qui peut entraîner l’interlacement involontaire de données à partir de plusieurs demandes d’envoi simultanées sur le même socket orienté flux.

Exemple de code

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

Exemple de code

Remarques pour les sockets IrDA

• Le fichier d’en-tête Af_irda.h doit être inclus explicitement.

Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.

Configuration requise

Voir aussi

Prise en main avec Winsock

WSAAsyncSelect

WSAEventSelect

Winsock Functions

Référence Winsock

Recv

recvfrom

select

Sendto

socket