fonction connect (winsock2.h)

La fonction connect établit une connexion à un socket spécifié.

Syntaxe

int WSAAPI connect(
  [in] SOCKET         s,
  [in] const sockaddr *name,
  [in] int            namelen
);

Paramètres

[in] s

Descripteur identifiant un socket non connecté.

[in] name

Pointeur vers la structure sockaddr à laquelle la connexion doit être établie.

[in] namelen

Longueur, en octets, de la structure sockaddr pointée vers le paramètre name .

Valeur retournée

Si aucune erreur ne se produit, la connexion retourne zéro. Sinon, il retourne SOCKET_ERROR, et un code d’erreur spécifique peut être récupéré en appelant WSAGetLastError.

Sur un socket bloquant, la valeur de retour indique la réussite ou l’échec de la tentative de connexion.

Avec un socket non bloquant, la tentative de connexion ne peut pas être effectuée immédiatement. Dans ce cas, connect retourne SOCKET_ERROR, et WSAGetLastError retourne WSAEWOULDBLOCK. Dans ce cas, il existe trois scénarios possibles :

• Utilisez la fonction select pour déterminer l’achèvement de la demande de connexion en vérifiant si le socket est accessible en écriture.
• Si l’application utilise WSAAsyncSelect pour indiquer son intérêt pour les événements de connexion, l’application reçoit une notification FD_CONNECT indiquant que l’opération de connexion est terminée (avec succès ou non).
• Si l’application utilise WSAEventSelect pour indiquer l’intérêt pour les événements de connexion, l’objet d’événement associé est signalé indiquant que l’opération de connexion est terminée (avec succès ou non).

Tant que la tentative de connexion n’est pas terminée sur un socket non bloquant, tous les appels suivants pour se connecter sur le même socket échouent avec le code d’erreur WSAEALREADY et WSAEISCONN lorsque la connexion se termine correctement. En raison d’ambiguïtés dans la version 1.1 de la spécification des sockets Windows, les codes d’erreur retournés par la connexion alors qu’une connexion est déjà en attente peuvent varier d’une implémentation à l’autre. Par conséquent, il n’est pas recommandé que les applications utilisent plusieurs appels pour se connecter afin de détecter l’achèvement de la connexion. Si c’est le cas, ils doivent être prêts à gérer les valeurs d’erreur WSAEINVAL et WSAEWOULDBLOCK de la même façon qu’ils gèrent WSAEALREADY, pour garantir un fonctionnement robuste.

Si le code d’erreur retourné indique que la tentative de connexion a échoué ( c’est-à-dire, WSAECONNREFUSED, WSAENETUNREACH, WSAETIMEDOUT), l’application peut appeler à nouveau la connexion pour le même socket.

Remarques

La fonction connect est utilisée pour créer une connexion à la destination spécifiée. Si socket s, est non lié, les valeurs uniques sont attribuées à l’association locale par le système, et le socket est marqué comme lié.

Pour les sockets orientés connexion (par exemple, le type SOCK_STREAM), une connexion active est lancée à l’hôte étranger à l’aide du nom (une adresse dans l’espace de noms du socket ; pour une description détaillée, voir bind et sockaddr).

Une fois l’appel de socket terminé, le socket est prêt à envoyer et à recevoir des données. Si le membre d’adresse de la structure spécifiée par le paramètre name est rempli de zéros, la connexion retourne l’erreur WSAEADDRNOTAVAIL. Toute tentative de reconnexion d’une connexion active échoue avec le code d’erreur WSAEISCONN.

Pour les sockets orientés connexion et non bloquants, il n’est souvent pas possible de terminer la connexion immédiatement. Dans ce cas, cette fonction retourne l’erreur WSAEWOULDBLOCK. Toutefois, l’opération continue.

Lorsque le résultat de la réussite ou de l’échec est connu, il peut être signalé de l’une des deux manières, selon la façon dont le client s’inscrit pour la notification.

• Si le client utilise la fonction select , la réussite est signalée dans le jeu writefds et l’échec est signalé dans le jeu exceptfds.
• Si le client utilise les fonctions WSAAsyncSelect ou WSAEventSelect, la notification est annoncée avec FD_CONNECT et le code d’erreur associé au FD_CONNECT indique la réussite ou une raison spécifique de l’échec.

Si la connexion n’est pas terminée immédiatement, le client doit attendre l’achèvement de la connexion avant d’essayer de définir les options de socket à l’aide de setsockopt. L’appel de setsockopt lorsqu’une connexion est en cours n’est pas pris en charge.

Pour un socket sans connexion (par exemple, le type SOCK_DGRAM), l’opération effectuée par connect consiste simplement à établir une adresse de destination par défaut qui peut être utilisée lors des appelsWSASend et recv/ ultérieurs / WSARecv. Tous les datagrammes reçus d’une adresse autre que l’adresse de destination spécifiée seront ignorés. Si le membre d’adresse de la structure spécifiée par nom est rempli de zéros, le socket est déconnecté. Ensuite, l’adresse distante par défaut étant indéterminée, l’envoi/ d’appelsWSASend et recv/ WSARecv retourne le code d’erreur WSAENOTCONN. Toutefois, sendto/ WSASendTo et recvfrom/ WSARecvFrom peuvent toujours être utilisés. La destination par défaut peut être modifiée en appelant simplement se connecter à nouveau, même si le socket est déjà connecté. Tous les datagrammes mis en file d’attente pour réception sont ignorés si le nom est différent de la connexion précédente.

Pour les sockets sans connexion, le nom peut indiquer n’importe quelle adresse valide, y compris une adresse de diffusion. Toutefois, pour se connecter à une adresse de diffusion, un socket doit utiliser setsockopt pour activer l’option SO_BROADCAST. Sinon, la connexion échoue avec le code d’erreur WSAEACCES.

Lorsqu’une connexion entre des sockets est interrompue, le socket connecté doit être ignoré et un nouveau socket doit être créé. Lorsqu’un problème se développe sur un socket connecté, l’application doit ignorer le socket et le recréer afin de revenir à un point stable.

Exemple de code

#ifndef UNICODE
#define UNICODE
#endif

#define WIN32_LEAN_AND_MEAN

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

// Need to link with Ws2_32.lib
#pragma comment(lib, "ws2_32.lib")

int wmain()
{
    //----------------------
    // Initialize Winsock
    WSADATA wsaData;
    int iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult != NO_ERROR) {
        wprintf(L"WSAStartup function failed with error: %d\n", iResult);
        return 1;
    }
    //----------------------
    // Create a SOCKET for connecting to server
    SOCKET ConnectSocket;
    ConnectSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (ConnectSocket == INVALID_SOCKET) {
        wprintf(L"socket function 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.
    sockaddr_in clientService;
    clientService.sin_family = AF_INET;
    clientService.sin_addr.s_addr = inet_addr("127.0.0.1");
    clientService.sin_port = htons(27015);

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

    wprintf(L"Connected to server.\n");

    iResult = closesocket(ConnectSocket);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"closesocket function failed with error: %ld\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    WSACleanup();
    return 0;
}

Pour un autre exemple qui utilise la fonction connect, consultez Prise en main Avec Winsock.

Remarques pour les sockets IrDA

• Le fichier d’en-tête Af_irda.h doit être inclus explicitement.
• Si une connexion IrDA existante est détectée au niveau de l’accès au média, WSAENETDOWN est retourné.
• S’il existe des connexions actives à un appareil avec une adresse différente, WSAEADDRINUSE est retourné.
• Si le socket est déjà connecté ou si un changement de mode exclusif/multiplexé a échoué, WSAEISCONN est retourné.
• Si le socket était précédemment lié à un nom de service local pour accepter les connexions entrantes à l’aide de bind, WSAEINVAL est retourné. Notez qu’une fois qu’un socket est lié, il ne peut pas être utilisé pour établir une connexion sortante.

IrDA implémente la fonction de connexion avec les adresses du formulaire sockaddr_irda. En règle générale, une application cliente crée un socket avec la fonction socket, analyse le voisinage immédiat des appareils IrDA avec l’option de socket IRLMP_ENUMDEVICES, choisit un appareil dans la liste retournée, forme une adresse, puis appelle connect. Il n’y a aucune différence entre la sémantique bloquante et non bloquante.

Configuration requise

Voir aussi

WSAAsyncSelect

WSAConnect

ConnectEx

Fonctions Winsock

Informations de référence sur Winsock

Accepter

bind

getsockname

select

sockaddr

socket