funzione connect (winsock2.h)

La funzione connect stabilisce una connessione a un socket specificato.

Sintassi

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

Parametri

[in] s

Descrittore che identifica un socket non connesso.

[in] name

Puntatore alla struttura sockaddr a cui deve essere stabilita la connessione.

[in] namelen

Lunghezza, in byte, della struttura sockaddr a cui punta il parametro name .

Valore restituito

Se non si verifica alcun errore, la connessione restituisce zero. In caso contrario, restituisce SOCKET_ERROR e un codice di errore specifico può essere recuperato chiamando WSAGetLastError.

In un socket di blocco, il valore restituito indica l'esito positivo o negativo del tentativo di connessione.

Con un socket non bloccante, il tentativo di connessione non può essere completato immediatamente. In questo caso, la connessione restituirà SOCKET_ERROR e WSAGetLastError restituirà WSAEWOULDBLOCK. In questo caso, esistono tre possibili scenari:

• Usare la funzione select per determinare il completamento della richiesta di connessione controllando se il socket è scrivibile.
• Se l'applicazione usa WSAAsyncSelect per indicare l'interesse per gli eventi di connessione, l'applicazione riceverà una notifica di FD_CONNECT che indica che l'operazione di connessione è stata completata (correttamente o meno).
• Se l'applicazione usa WSAEventSelect per indicare l'interesse per gli eventi di connessione, l'oggetto evento associato verrà segnalato che l'operazione di connessione è stata completata (correttamente o meno).

Finché il tentativo di connessione non viene completato su un socket non bloccante, tutte le chiamate successive per la connessione sullo stesso socket avranno esito negativo con il codice di errore WSAEALREADY e WSAEISCONN al termine della connessione. A causa di ambiguità nella versione 1.1 della specifica Windows Sockets, i codici di errore restituiti dalla connessione mentre una connessione è già in sospeso possono variare tra le implementazioni. Di conseguenza, non è consigliabile che le applicazioni usino più chiamate per connettersi per rilevare il completamento della connessione. In tal caso, devono essere preparati a gestire i valori di errore WSAEINVAL e WSAEWOULDBLOCK allo stesso modo in cui gestiscono WSAEALREADY, per garantire un'operazione affidabile.

Se il codice di errore restituito indica che il tentativo di connessione non è riuscito, ovvero WSAECONNREFUSED, WSAENETUNREACH, WSAETIMEDOUT, l'applicazione può chiamare di nuovo la connessione per lo stesso socket.

Commenti

La funzione connect viene usata per creare una connessione alla destinazione specificata. Se socket s, non è associato, i valori univoci vengono assegnati all'associazione locale dal sistema e il socket viene contrassegnato come associato.

Per i socket orientati alla connessione (ad esempio, digitare SOCK_STREAM), viene avviata una connessione attiva all'host esterno usando il nome (un indirizzo nello spazio dei nomi del socket; per una descrizione dettagliata, vedere bind e sockaddr).

Al termine della chiamata socket, il socket è pronto per l'invio e la ricezione dei dati. Se il membro dell'indirizzo della struttura specificata dal parametro name viene compilato con zeri, connect restituirà l'errore WSAEADDRNOTAVAIL. Qualsiasi tentativo di riconnessione di una connessione attiva avrà esito negativo con il codice di errore WSAEISCONN.

Per i socket non bloccanti orientati alla connessione, spesso non è possibile completare immediatamente la connessione. In questo caso, questa funzione restituisce l'errore WSAEWOULDBLOCK. Tuttavia, l'operazione procede.

Quando il risultato dell'esito positivo o negativo diventa noto, può essere segnalato in uno dei due modi, a seconda del modo in cui il client esegue la registrazione per la notifica.

• Se il client usa la funzione select , l'esito positivo viene segnalato nel set writefds e l'errore viene segnalato nel set exceptfds.
• Se il client usa le funzioni WSAAsyncSelect o WSAEventSelect, la notifica viene annunciata con FD_CONNECT e il codice di errore associato al FD_CONNECT indica l'esito positivo o un motivo specifico per l'errore.

Se la connessione non viene completata immediatamente, il client deve attendere il completamento della connessione prima di tentare di impostare le opzioni socket usando setsockopt. La chiamata a setsockopt mentre è in corso una connessione non è supportata.

Per un socket senza connessione (ad esempio, digitare SOCK_DGRAM), l'operazione eseguita dalla connessione consiste semplicemente nell'stabilire un indirizzo di destinazione predefinito che può essere usato nelle / successive chiamateWSASend eWSARecv/ successive. Gli eventuali datagrammi ricevuti da un indirizzo diverso dall'indirizzo di destinazione specificato verranno eliminati. Se il membro dell'indirizzo della struttura specificata dal nome viene riempito con zeri, il socket verrà disconnesso. Quindi, l'indirizzo remoto predefinito sarà indeterminato, quindi inviare/ WSASend e ricevere/ chiamateWSARecv restituirà il codice di errore WSAENOTCONN. È tuttavia possibile usare sendto/ WSASendTo e recvfrom/ WSARecvFrom . La destinazione predefinita può essere modificata semplicemente chiamando di nuovo la connessione , anche se il socket è già connesso. Gli eventuali datagrammi accodati per la ricevuta vengono eliminati se il nome è diverso dalla connessione precedente.

Per i socket senza connessione, il nome può indicare qualsiasi indirizzo valido, incluso un indirizzo broadcast. Tuttavia, per connettersi a un indirizzo broadcast, un socket deve usare setsockopt per abilitare l'opzione SO_BROADCAST. In caso contrario, la connessione avrà esito negativo con il codice di errore WSAEACCES.

Quando una connessione tra socket viene interrotta, il socket connesso deve essere rimosso e deve essere creato un nuovo socket. Quando si verifica un problema su un socket connesso, l'applicazione deve rimuovere il socket e creare di nuovo il socket per tornare a un punto stabile.

Codice di esempio

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

Per un altro esempio che usa la funzione connect, vedere Introduzione Con Winsock.

Note per i socket IrDA

• Il file di intestazione Af_irda.h deve essere incluso in modo esplicito.
• Se viene rilevata una connessione IrDA esistente a livello di accesso multimediale, viene restituito WSAENETDOWN .
• Se esistono connessioni attive a un dispositivo con un indirizzo diverso, viene restituito WSAEADDRINUSE .
• Se il socket è già connesso o una modifica della modalità esclusiva/multiplexed non riuscita, viene restituito WSAEISCONN .
• Se il socket è stato associato in precedenza a un nome di servizio locale per accettare connessioni in ingresso tramite bind, viene restituito WSAEINVAL . Si noti che una volta associato un socket, non può essere usato per stabilire una connessione in uscita.

IrDA implementa la funzione connect con indirizzi del modulo sockaddr_irda. In genere, un'applicazione client creerà un socket con la funzione socket, analizzerà la prossimità immediata per i dispositivi IrDA con l'opzione socket IRLMP_ENUMDEVICES, scegli un dispositivo dall'elenco restituito, formerà un indirizzo e quindi chiamerà la connessione. Non esiste alcuna differenza tra la semantica di blocco e non di blocco.

Requisiti

Vedi anche

WSAAsyncSelect

WSAConnect

ConnectEx

Funzioni Winsock

Informazioni di riferimento su Winsock

Accettare

bind

getsockname

select

sockaddr

Socket