WSAConnectByNameA 함수(winsock2.h)

WSAConnectByName 함수는 지정된 호스트 및 포트에 대한 연결을 설정합니다. 이 함수는 호스트 이름 및 포트가 지정된 네트워크 엔드포인트에 빠르게 연결할 수 있도록 제공됩니다.

이 함수는 IPv4 및 IPv6 주소를 모두 지원합니다.

통사론

BOOL WSAConnectByNameA(
  [in]      SOCKET          s,
  [in]      LPCSTR          nodename,
  [in]      LPCSTR          servicename,
  [in, out] LPDWORD         LocalAddressLength,
  [out]     LPSOCKADDR      LocalAddress,
  [in, out] LPDWORD         RemoteAddressLength,
  [out]     LPSOCKADDR      RemoteAddress,
  [in]      const timeval   *timeout,
            LPWSAOVERLAPPED Reserved
);

매개 변수

[in] s

연결되지 않은 소켓을 식별하는 설명자입니다.

[in] nodename

IPv4 또는 IPv6에 연결할 호스트의 이름 또는 호스트의 IP 주소를 포함하는 NULL종료된 문자열입니다.

[in] servicename

IPv4 또는 IPv6에 연결할 호스트의 서비스 이름 또는 대상 포트를 포함하는 NULL종료된 문자열입니다.

서비스 이름은 포트 번호의 문자열 별칭입니다. 예를 들어 "http"는 IETF(인터넷 엔지니어링 태스크 포스)에서 HTTP 프로토콜에 대해 웹 서버에서 사용하는 기본 포트로 정의된 포트 80의 별칭입니다. 포트 번호를 지정하지 않은 경우 servicename 매개 변수에 대한 가능한 값이 다음 파일에 나열됩니다.

%WINDIR%\system32\drivers\etc\services

[in, out] LocalAddressLength

입력 시 호출자가 제공한 LocalAddress 버퍼의 크기(바이트)에 대한 포인터입니다. 출력 시 호출이 성공적으로 완료되면 시스템에서 채워진 LocalAddress 버퍼에 저장된 로컬 주소에 대한 SOCKADDR 크기(바이트)에 대한 포인터입니다.

[out] LocalAddress

연결의 로컬 주소를 수신하는 SOCKADDR 구조체에 대한 포인터입니다. 매개 변수의 크기는 LocalAddressLength반환된 크기입니다. 이 정보는 getsockname 함수에서 반환되는 것과 동일한 정보입니다. 이 매개 변수는 NULL수 있습니다. 이 경우 LocalAddressLength 매개 변수는 무시됩니다.

[in, out] RemoteAddressLength

입력 시 호출자가 제공하는 RemoteAddress 버퍼의 크기(바이트)에 대한 포인터입니다. 출력 시 호출이 성공적으로 완료되면 시스템에서 채워진 RemoteAddress 버퍼에 저장된 원격 주소에 대한 SOCKADDR 크기(바이트)에 대한 포인터입니다.

[out] RemoteAddress

연결의 원격 주소를 수신하는 SOCKADDR 구조체에 대한 포인터입니다. 이 정보는 getpeername 함수에서 반환되는 것과 동일한 정보입니다. 이 매개 변수는 NULL수 있습니다. 이 경우 RemoteAddressLength 무시됩니다.

[in] timeout

호출을 중단하기 전에 원격 애플리케이션의 응답을 기다리는 시간(밀리초)입니다.

Reserved

향후 구현을 위해 예약됩니다. 이 매개 변수는 NULL설정해야 합니다.

반환 값

연결이 설정되면 WSAConnectByName TRUE 반환하고, 호출자가 이러한 버퍼를 제공한 경우 LocalAddress 및 RemoteAddress 매개 변수가 채워지는 반환합니다.

호출이 실패하면 FALSE 반환됩니다. WSAGetLastError 호출하여 확장된 오류 정보를 가져올 수 있습니다.

발언

WSAConnectByName 제공되어 특정 포트의 원격 호스트에 빠르고 투명하게 연결할 수 있습니다. IPv6 및 IPv4 버전 모두와 호환됩니다.

IPv6 및 IPv4 통신을 모두 사용하도록 설정하려면 다음 방법을 사용합니다.

• setsockopt 함수는 WSAConnectByName호출하기 전에 IPV6_V6ONLY 소켓 옵션을 사용하지 않도록 설정하려면 AF_INET6 주소 패밀리에 대해 만든 소켓에서 호출해야 . 이 작업은 수준 매개 변수가 IPPROTO_IPV6(IPPROTO_IPV6 소켓 옵션참조), IPV6_V6ONLY설정된 optname 매개 변수 및 optvalue 매개 변수 값이 0으로 설정된 소켓에서 setsockopt 함수를 호출하여 수행됩니다.

WSAConnectByName 제한 사항이 있습니다. SOCK_STREAM 형식과 같은 연결 지향 소켓에만 작동합니다. 이 함수는 겹치는 I/O 또는 비차단 동작을 지원하지 않습니다. WSAConnectByName 소켓이 비차단 모드인 경우에도 차단됩니다.

WSAConnectByName 연결을 설정 하는 동안 사용자 제공 데이터를 지원 하지 않습니다. 이 호출은 FLOWSPEC 구조도 지원하지 않습니다. 이러한 기능이 필요한 경우 WSAConnect 대신 사용해야 합니다.

Windows 10 이전 버전에서는 애플리케이션이 특정 로컬 주소 또는 포트에 바인딩해야 하는 경우 WSAConnectByName 소켓 매개 변수가 언바운드 소켓이어야 하므로 WSAConnectByName 사용할 수 없습니다.

이 제한은 Windows 10에서 제거되었습니다.

RemoteAddress 및 LocalAddress 매개 변수는 제네릭 데이터 형식인 SOCKADDR 구조를 가리킵니다. WSAConnectByName 호출되면 사용 중인 네트워크 프로토콜 또는 주소 패밀리와 관련된 소켓 주소 유형이 실제로 이러한 매개 변수에 전달될 것으로 예상됩니다. 따라서 IPv4 주소의 경우 sockaddr_in 구조에 대한 포인터는 RemoteAddress SOCKADDR 대한 포인터로 캐스팅되고 LocalAddress 매개 변수를 . IPv6 주소의 경우 sockaddr_in6 구조체에 대한 포인터는 RemoteAddress SOCKADDR 대한 포인터로 캐스팅되고 LocalAddress 매개 변수를 .

WSAConnectByName 함수가 TRUE반환하면 소켓 연결된 소켓의 기본 상태입니다. 소켓 소켓에서 SO_UPDATE_CONNECT_CONTEXT 설정될 때까지 이전에 설정된 속성 또는 옵션을 사용하도록 설정하지 않습니다. setsockopt 함수를 사용하여 SO_UPDATE_CONNECT_CONTEXT 옵션을 설정합니다.

예를 들어:

//Need to #include <mswsock.h> for SO_UPDATE_CONNECT_CONTEXT

int iResult = 0;

iResult = setsockopt( s, SOL_SOCKET, SO_UPDATE_CONNECT_CONTEXT, NULL, 0 );

Windows 8.1 및 Windows Server 2012 R2: WSAConnectByNameW 함수는 Windows 8.1, Windows Server 2012 R2 이상의 Windows 스토어 앱에서 지원됩니다.

예제

WSAConnectByName사용하여 연결을 설정합니다.

#ifndef UNICODE
#define UNICODE
#endif

#define WIN32_LEAN_AND_MEAN

#include <winsock2.h>
#include <Ws2tcpip.h>
#include <mswsock.h>   // Need for SO_UPDATE_CONNECT_CONTEXT
#include <stdio.h>

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

SOCKET
OpenAndConnect(LPWSTR NodeName, LPWSTR PortName) 
{
    SOCKET ConnSocket = INVALID_SOCKET;
    int ipv6only = 0;
    int iResult;
    BOOL bSuccess;
    SOCKADDR_STORAGE LocalAddr = {0};
    SOCKADDR_STORAGE RemoteAddr = {0};
    DWORD dwLocalAddr = sizeof(LocalAddr);
    DWORD dwRemoteAddr = sizeof(RemoteAddr);
  
    ConnSocket = socket(AF_INET6, SOCK_STREAM, 0);
    if (ConnSocket == INVALID_SOCKET){
        wprintf(L"socket failed with error: %d\n", WSAGetLastError());
        return INVALID_SOCKET;
    }

    iResult = setsockopt(ConnSocket, IPPROTO_IPV6,
        IPV6_V6ONLY, (char*)&ipv6only, sizeof(ipv6only) );
    if (iResult == SOCKET_ERROR){
        wprintf(L"setsockopt for IPV6_V6ONLY failed with error: %d\n",
            WSAGetLastError());
        closesocket(ConnSocket);
        return INVALID_SOCKET;       
    }

    bSuccess = WSAConnectByName(ConnSocket, NodeName, 
            PortName, &dwLocalAddr,
            (SOCKADDR*)&LocalAddr,
            &dwRemoteAddr,
            (SOCKADDR*)&RemoteAddr,
            NULL,
            NULL);
    if (!bSuccess){
        wprintf(L"WsaConnectByName failed with error: %d\n", WSAGetLastError());
        closesocket(ConnSocket);
        return INVALID_SOCKET;       

    
    }

    iResult = setsockopt(ConnSocket, SOL_SOCKET,
        SO_UPDATE_CONNECT_CONTEXT, NULL, 0);
    if (iResult == SOCKET_ERROR){
        wprintf(L"setsockopt for SO_UPDATE_CONNECT_CONTEXT failed with error: %d\n",
            WSAGetLastError());
        closesocket(ConnSocket);
        return INVALID_SOCKET;       
    }

    return ConnSocket;
}

int __cdecl wmain(int argc, wchar_t **argv)
{
   //-----------------------------------------
    // Declare and initialize variables
    WSADATA wsaData;
    int iResult;

    SOCKET s = INVALID_SOCKET;

    // Validate the parameters
    if (argc != 3) {
        wprintf(L"usage: %ws <Nodename> <Portname>\n", argv[0]);
        wprintf(L"wsaconnectbyname establishes a connection to a specified host and port.\n");
        wprintf(L"%ws www.contoso.com 8080\n", argv[0]);
        return 1;
    }

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

    wprintf(L"WsaConnectByName with following parameters:\n");
    wprintf(L"\tNodename = %ws\n", argv[1]);
    wprintf(L"\tPortname (or port) = %ws\n\n", argv[2]);

    //--------------------------------
    // Call our function that uses the WsaConnectByName. 
    
    s = OpenAndConnect(argv[1], argv[2]);
    if ( s == INVALID_SOCKET ) {
        wprintf(L"WsaConnectByName failed with error: %d\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }
    else
    {
        wprintf(L"WsaConnectByName succeeded\n");
        
        closesocket(s);
        WSACleanup();
        return 0;
    }
}

요구 사항

참고 항목

IPPROTO_IPV6 소켓 옵션

SOCKADDR

WSAConnect

WSAConnectByList

WSAGetLastError

getaddrinfo

getpeername

getsockname

setsockopt