다음을 통해 공유

CAsyncSocket 클래스

  • 아티클

네트워크 통신의 엔드포인트인 Windows 소켓을 나타냅니다.

구문

class CAsyncSocket : public CObject

멤버

공용 생성자

속성 설명
CAsyncSocket::CAsyncSocket CAsyncSocket 개체를 생성합니다.

공용 메서드

이름 설명
CAsyncSocket::Accept 소켓에서 연결을 허용합니다.
CAsyncSocket::AsyncSelect 소켓에 대한 이벤트 알림을 요청합니다.
CAsyncSocket::Attach 개체에 소켓 핸들을 CAsyncSocket 연결합니다.
CAsyncSocket::Bind 로컬 주소를 소켓과 연결합니다.
CAsyncSocket::Close 소켓을 닫습니다.
CAsyncSocket::Connect 피어 소켓에 대한 연결을 설정합니다.
CAsyncSocket::Create 소켓을 만듭니다.
CAsyncSocket::CreateEx 고급 옵션을 사용하여 소켓을 만듭니다.
CAsyncSocket::Detach 개체에서 소켓 핸들을 CAsyncSocket 분리합니다.
CAsyncSocket::FromHandle 소켓 핸들이 지정된 개체에 대한 CAsyncSocket 포인터를 반환합니다.
CAsyncSocket::GetLastError 실패한 마지막 작업에 대한 오류 상태 가져옵니다.
CAsyncSocket::GetPeerName 소켓이 연결된 피어 소켓의 주소를 가져옵니다.
CAsyncSocket::GetPeerNameEx 소켓이 연결된 피어 소켓의 주소를 가져옵니다(IPv6 주소 처리).
CAsyncSocket::GetSockName 소켓의 로컬 이름을 가져옵니다.
CAsyncSocket::GetSockNameEx 소켓의 로컬 이름을 가져옵니다(IPv6 주소 처리).
CAsyncSocket::GetSockOpt 소켓 옵션을 검색합니다.
CAsyncSocket::IOCtl 소켓의 모드를 제어합니다.
CAsyncSocket::Listen 들어오는 연결 요청을 수신 대기하는 소켓을 설정합니다.
CAsyncSocket::Receive 소켓에서 데이터를 받습니다.
CAsyncSocket::ReceiveFrom 데이터그램을 수신하고 원본 주소를 저장합니다.
CAsyncSocket::ReceiveFromEx 데이터그램을 수신하고 원본 주소(IPv6 주소 처리)를 저장합니다.
CAsyncSocket::Send 데이터를 연결된 소켓으로 전송합니다.
CAsyncSocket::SendTo 특정 대상으로 데이터를 보냅니다.
CAsyncSocket::SendToEx 특정 대상으로 데이터를 보냅니다(IPv6 주소 처리).
CAsyncSocket::SetSockOpt 소켓 옵션을 설정합니다.
CAsyncSocket::ShutDown 소켓에서 Send 호출을 Receive 사용하지 않도록 설정합니다.
CASyncSocket::Socket 소켓 핸들을 할당합니다.

보호된 메서드

속성 설명
CAsyncSocket::OnAccept 를 호출 Accept하여 보류 중인 연결 요청을 수락할 수 있음을 수신 대기 소켓에 알깁니다.
CAsyncSocket::OnClose 연결된 소켓이 닫혔다는 것을 소켓에 알깁니다.
CAsyncSocket::OnConnect 연결 소켓에 연결 시도가 완료되었음을 알릴 수 있습니다(성공 여부 또는 오류 여부).
CAsyncSocket::OnOutOfBandData 수신 소켓에 대개 긴급 메시지인 소켓에서 읽을 대역 외 데이터가 있음을 알 수 있습니다.
CAsyncSocket::OnReceive 수신 대기 소켓에 호출 Receive하여 검색할 데이터가 있음을 알 수 있습니다.
CAsyncSocket::OnSend 를 호출 Send하여 데이터를 보낼 수 있음을 소켓에 알깁니다.

Public 연산자

이름 설명
CAsyncSocket::operator = 개체에 새 값을 CAsyncSocket 할당합니다.
CAsyncSocket::operator SOCKET 이 연산자를 사용하여 개체의 핸들을 SOCKET 검색합니다 CAsyncSocket .

공용 데이터 멤버

이름 설명
CAsyncSocket::m_hSocket 이 CAsyncSocket 개체에 SOCKET 연결된 핸들을 나타냅니다.

설명

클래스 CAsyncSocket 는 Windows 소켓 함수 API를 캡슐화하여 MFC와 함께 Windows 소켓을 사용하려는 프로그래머에게 개체 지향 추상화를 제공합니다.

이 클래스는 네트워크 통신을 이해한다는 가정을 기반으로 합니다. 차단, 바이트 순서 차이 및 유니코드와 MBCS(멀티바이트 문자 집합) 문자열 간의 변환을 처리해야 합니다. 이러한 문제를 관리하는 보다 편리한 인터페이스를 원하는 경우 클래스를 참조하세요 CSocket.

개체를 CAsyncSocket 사용하려면 해당 생성자를 호출한 다음 함수를 호출 Create 하여 허용되는 소켓을 제외하고 기본 소켓 핸들(형식 SOCKET)을 만듭니다. 서버 소켓의 경우 멤버 함수를 Listen 호출하고 클라이언트 소켓의 경우 멤버 함수를 호출합니다 Connect . 서버 소켓은 연결 요청을 받으면 함수를 호출 Accept 해야 합니다. 다시 기본 함수를 CAsyncSocket 사용하여 소켓 간 통신을 수행합니다. 완료되면 개체가 CAsyncSocket 힙에 만들어진 경우 개체를 삭제합니다. 소멸자가 자동으로 함수를 Close 호출합니다. 데이터 형식은 SOCKET Windows 소켓: 백그라운드 문서에 설명되어 있습니다.

참고 항목

정적으로 연결된 MFC 애플리케이션의 보조 스레드에서 MFC 소켓을 사용하는 경우 소켓을 사용하여 소켓 라이브러리를 초기화하는 각 스레드에서 호출 AfxSocketInit 해야 합니다. 기본적으로 AfxSocketInit 기본 스레드에서만 호출됩니다.

자세한 내용은 Windows 소켓: 클래스 CAsyncSocket 및 관련 문서 사용 및 Windows 소켓 2 API를 참조하세요.

상속 계층 구조

CObject

CAsyncSocket

요구 사항

헤더afxsock.h:

CAsyncSocket::Accept

소켓에서 연결을 허용하려면 이 멤버 함수를 호출합니다.

virtual BOOL Accept(
    CAsyncSocket& rConnectedSocket,
    SOCKADDR* lpSockAddr = NULL,
    int* lpSockAddrLen = NULL);

매개 변수

rConnectedSocket
연결에 사용할 수 있는 새 소켓을 식별하는 참조입니다.

lpSockAddr
네트워크에서 알려진 연결 소켓의 주소를 받는 구조체에 대한 포인터 SOCKADDR 입니다. 인수의 lpSockAddr 정확한 형식은 소켓을 만들 때 설정된 주소 패밀리에 의해 결정됩니다. 및/또는 lpSockAddrLen 같NULL으면 lpSockAddr 허용된 소켓의 원격 주소에 대한 정보가 반환되지 않습니다.

lpSockAddrLen
주소 길이(바이트)에 lpSockAddr 대한 포인터입니다. 값 lpSockAddrLen 결과 매개 변수입니다. 처음에는 가리키는 lpSockAddr공간의 양을 포함해야 합니다. 반환 시 반환된 주소의 실제 길이(바이트)를 포함합니다.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEFAULTlpSockAddrLen 인수가 너무 작습니다(구조체의 SOCKADDR 크기보다 작음).

  • WSAEINPROGRESS 차단 Windows 소켓 호출이 진행 중입니다.

  • WSAEINVALListen 수락하기 전에 호출되지 않았습니다.

  • WSAEMFILE 큐는 수락할 항목이 비어 있으며 사용할 수 있는 설명자가 없습니다.

  • WSAENOBUFS 사용할 수 있는 버퍼 공간이 없습니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAEOPNOTSUPP 참조된 소켓은 연결 지향 서비스를 지원하는 형식이 아닙니다.

  • WSAEWOULDBLOCK 소켓이 차단 해제로 표시되고 허용될 연결이 없습니다.

설명

이 루틴은 보류 중인 연결 큐의 첫 번째 연결을 추출하고, 이 소켓과 동일한 속성을 가진 새 소켓을 만들고, 연결합니다 rConnectedSocket. 큐 Accept 에 보류 중인 연결이 없으면 0을 반환하고 GetLastError 오류를 반환합니다. 허용되는 소켓(rConnectedSocket)은 더 많은 연결을 허용하는 데 사용할 수 없습니다. 원래 소켓이 다시 열리고 수신 대기하는 기본.

인수 lpSockAddr 는 통신 계층에 알려진 연결 소켓의 주소로 채워진 결과 매개 변수입니다. Accept 는 연결 기반 소켓 유형(예: .) SOCK_STREAM과 함께 사용됩니다.

CAsyncSocket::AsyncSelect

소켓에 대한 이벤트 알림을 요청하려면 이 멤버 함수를 호출합니다.

BOOL AsyncSelect(long lEvent = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE);

매개 변수

lEvent
애플리케이션에 관심이 있는 네트워크 이벤트의 조합을 지정하는 비트 마스크입니다.

  • FD_READ 읽기 준비 상태 알림을 받으려고 합니다.

  • FD_WRITE 데이터를 읽을 수 있는 경우 알림을 받으려고 합니다.

  • FD_OOB 대역 외 데이터의 도착 알림을 받으려고 합니다.

  • FD_ACCEPT 들어오는 연결에 대한 알림을 받으려고 합니다.

  • FD_CONNECT 연결 결과에 대한 알림을 받으려고 합니다.

  • FD_CLOSE 피어에 의해 소켓이 닫혔을 때 알림을 받으려고 합니다.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEINVAL 지정된 매개 변수 중 하나가 잘못되었음을 나타냅니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

설명

이 함수는 소켓에 대해 호출될 MFC 콜백 알림 함수를 지정하는 데 사용됩니다. AsyncSelect 는 자동으로 이 소켓을 차단 해제 모드로 설정합니다. 자세한 내용은 Windows 소켓: 소켓 알림 문서를 참조하세요.

CAsyncSocket::Attach

개체에 핸들을 hSocket 연결하려면 이 멤버 함수를 CAsyncSocket 호출합니다.

BOOL Attach(
    SOCKET hSocket, long lEvent = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE);

매개 변수

hSocket
소켓에 대한 핸들을 포함합니다.

lEvent
애플리케이션에 관심이 있는 네트워크 이벤트의 조합을 지정하는 비트 마스크입니다.

  • FD_READ 읽기 준비 상태 알림을 받으려고 합니다.

  • FD_WRITE 데이터를 읽을 수 있는 경우 알림을 받으려고 합니다.

  • FD_OOB 대역 외 데이터의 도착 알림을 받으려고 합니다.

  • FD_ACCEPT 들어오는 연결에 대한 알림을 받으려고 합니다.

  • FD_CONNECT 연결 결과에 대한 알림을 받으려고 합니다.

  • FD_CLOSE 피어에 의해 소켓이 닫혔을 때 알림을 받으려고 합니다.

Return Value

함수가 성공하는 경우 0이 아닙니다.

설명

SOCKET 핸들은 개체의 m_hSocket 데이터 멤버에 저장됩니다.

CAsyncSocket::Bind

이 멤버 함수를 호출하여 로컬 주소를 소켓과 연결합니다.

BOOL Bind(
    UINT nSocketPort,
    LPCTSTR lpszSocketAddress = NULL);

BOOL Bind (
    const SOCKADDR* lpSockAddr,
    int nSockAddrLen);

매개 변수

nSocketPort
소켓 애플리케이션을 식별하는 포트입니다.

lpszSocketAddress
네트워크 주소, 점선 번호(예: "128.56.22.8")입니다. 이 매개 변수에 대한 문자열을 NULL 전달하면 인스턴스가 CAsyncSocket 모든 네트워크 인터페이스에서 클라이언트 작업을 수신 대기해야 임을 나타냅니다.

lpSockAddr
이 소켓에 SOCKADDR 할당할 주소를 포함하는 구조체에 대한 포인터입니다.

nSockAddrLen
주소의 길이( lpSockAddr 바이트)입니다.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 목록에서는 반환될 수 있는 몇 가지 오류에 대해 설명합니다. 전체 목록은 Windows 소켓 오류 코드를 참조 하세요.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEADDRINUSE 지정된 주소가 이미 사용 중입니다. (.에서 SetSockOpt소켓 옵션을 참조하세요SO_REUSEADDR.)

  • WSAEFAULTnSockAddrLen 인수가 너무 작습니다(구조체의 SOCKADDR 크기보다 작음).

  • WSAEINPROGRESS 차단 Windows 소켓 호출이 진행 중입니다.

  • WSAEAFNOSUPPORT 지정된 주소 패밀리는 이 포트에서 지원되지 않습니다.

  • WSAEINVAL 소켓이 이미 주소에 바인딩되어 있습니다.

  • WSAENOBUFS 사용 가능한 버퍼가 부족하고 연결이 너무 많습니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

설명

이 루틴은 연결되지 않은 데이터그램 또는 스트림 소켓에서 후속 Connect 또는 Listen 호출 전에 사용됩니다. 연결 요청을 수락하려면 먼저 수신 대기 서버 소켓에서 포트 번호를 선택하고 호출 Bind하여 Windows 소켓에 알려야 합니다. Bind 는 이름 없는 소켓에 로컬 이름을 할당하여 소켓의 로컬 연결(호스트 주소/포트 번호)을 설정합니다.

CAsyncSocket::CAsyncSocket

빈 소켓 개체를 생성합니다.

CAsyncSocket();

설명

개체를 생성한 후 해당 멤버 함수를 Create 호출하여 데이터 구조를 만들고 SOCKET 해당 주소를 바인딩해야 합니다. (Windows 소켓 통신의 서버 쪽에서 수신 소켓이 호출에 Accept 사용할 소켓을 만들 때 해당 소켓을 호출 Create 하지 않습니다.)

CAsyncSocket::Close

소켓을 닫습니다.

virtual void Close();

설명

이 함수는 소켓 설명자를 해제하여 해당 설명자에 대한 추가 참조가 오류 WSAENOTSOCK와 함께 실패하도록 합니다. 이 값이 기본 소켓에 대한 마지막 참조인 경우 연결된 명명 정보 및 큐에 대기 중인 데이터가 카드. 소켓 개체의 소멸자가 호출 Close 합니다.

의 의미 CAsyncSocket체계는 소켓 옵션 SO_LINGER 및 SO_DONTLINGER.의 Close 영향을 받지 않습니다CSocket. 자세한 내용은 멤버 함수 GetSockOpt를 참조하세요.

CAsyncSocket::Connect

연결되지 않은 스트림 또는 데이터그램 소켓에 대한 연결을 설정하려면 이 멤버 함수를 호출합니다.

BOOL Connect(
    LPCTSTR lpszHostAddress,
    UINT nHostPort);

BOOL Connect(
    const SOCKADDR* lpSockAddr,
    int nSockAddrLen);

매개 변수

lpszHostAddress
이 개체가 연결된 소켓의 네트워크 주소: "ftp.microsoft.com"과 같은 컴퓨터 이름 또는 점선 번호(예: "128.56.22.8")입니다.

nHostPort
소켓 애플리케이션을 식별하는 포트입니다.

lpSockAddr
연결된 소켓의 SOCKADDR 주소를 포함하는 구조체에 대한 포인터입니다.

nSockAddrLen
주소의 길이( lpSockAddr 바이트)입니다.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 오류 코드가 표시되고 애플리케이션이 재정의 WSAEWOULDBLOCK가능한 콜백을 사용하는 경우 연결 작업이 완료되면 애플리케이션에서 메시지를 받게 OnConnect 됩니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEADDRINUSE 지정된 주소가 이미 사용 중입니다.

  • WSAEINPROGRESS 차단 Windows 소켓 호출이 진행 중입니다.

  • WSAEADDRNOTAVAIL 지정된 주소를 로컬 컴퓨터에서 사용할 수 없습니다.

  • WSAEAFNOSUPPORT 지정된 패밀리의 주소는 이 소켓과 함께 사용할 수 없습니다.

  • WSAECONNREFUSED 연결 시도가 거부되었습니다.

  • WSAEDESTADDRREQ 대상 주소가 필요합니다.

  • WSAEFAULT 인수가 nSockAddrLen 잘못되었습니다.

  • WSAEINVAL 호스트 주소가 잘못되었습니다.

  • WSAEISCONN 소켓이 이미 연결되어 있습니다.

  • WSAEMFILE 더 이상 파일 설명자를 사용할 수 없습니다.

  • WSAENETUNREACH 현재 이 호스트에서 네트워크에 연결할 수 없습니다.

  • WSAENOBUFS 사용할 수 있는 버퍼 공간이 없습니다. 소켓을 연결할 수 없습니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAETIMEDOUT 연결을 설정하지 않고 시간이 초과된 연결을 시도합니다.

  • WSAEWOULDBLOCK 소켓이 차단 해제로 표시되고 연결을 즉시 완료할 수 없습니다.

설명

소켓이 언바운드인 경우 고유 값이 시스템에 의해 로컬 연결에 할당되고 소켓이 바인딩된 것으로 표시됩니다. 이름 구조의 주소 필드가 모두 0 Connect 이면 0을 반환합니다. 확장 오류 정보를 얻으려면 멤버 함수를 호출합니다 GetLastError .

스트림 소켓(형식 SOCK_STREAM)의 경우 활성 연결이 외세의 호스트에 시작됩니다. 소켓 호출이 성공적으로 완료되면 소켓이 데이터를 보내거나 받을 준비가 됩니다.

데이터그램 소켓(형식 SOCK_DGRAM)의 경우 기본 대상이 설정되며, 이 대상은 후속 Send 및 Receive 호출에 사용됩니다.

CAsyncSocket::Create

소켓 개체를 Create 생성한 후 멤버 함수를 호출하여 Windows 소켓을 만들고 연결합니다.

BOOL Create(
    UINT nSocketPort = 0,
    int nSocketType = SOCK_STREAM,
    long lEvent = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE,
    LPCTSTR lpszSocketAddress = NULL);

매개 변수

nSocketPort
소켓과 함께 사용할 잘 알려진 포트이거나 Windows 소켓이 포트를 선택하도록 하려는 경우 0입니다.

nSocketType
SOCK_STREAM 또는 SOCK_DGRAM.

lEvent
애플리케이션에 관심이 있는 네트워크 이벤트의 조합을 지정하는 비트 마스크입니다.

  • FD_READ 읽기 준비 상태 알림을 받으려고 합니다.

  • FD_WRITE 쓰기 준비 상태 알림을 받으려고 합니다.

  • FD_OOB 대역 외 데이터의 도착 알림을 받으려고 합니다.

  • FD_ACCEPT 들어오는 연결에 대한 알림을 받으려고 합니다.

  • FD_CONNECT 완료된 연결에 대한 알림을 받으려고 합니다.

  • FD_CLOSE 소켓 닫기 알림을 받으려고 합니다.

lpszSockAddress
연결된 소켓의 네트워크 주소를 포함하는 문자열에 대한 포인터로, 점선 번호(예: "128.56.22.8")입니다. 이 매개 변수에 대한 문자열을 NULL 전달하면 인스턴스가 CAsyncSocket 모든 네트워크 인터페이스에서 클라이언트 작업을 수신 대기해야 임을 나타냅니다.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEAFNOSUPPORT 지정된 주소 패밀리는 지원되지 않습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAEMFILE 더 이상 파일 설명자를 사용할 수 없습니다.

  • WSAENOBUFS 사용할 수 있는 버퍼 공간이 없습니다. 소켓을 만들 수 없습니다.

  • WSAEPROTONOSUPPORT 지정된 포트는 지원되지 않습니다.

  • WSAEPROTOTYPE 지정된 포트가 이 소켓의 잘못된 형식입니다.

  • WSAESOCKTNOSUPPORT 지정된 소켓 유형은 이 주소 패밀리에서 지원되지 않습니다.

설명

Create 가 호출 Socket 되고 성공하면 소켓을 지정된 주소에 바인딩하기 위해 호출 Bind 됩니다. 지원되는 소켓 유형은 다음과 같습니다.

  • SOCK_STREAM 시퀀싱된 신뢰할 수 있는 전체 이중 연결 기반 바이트 스트림을 제공합니다. 인터넷 주소 패밀리에 TCP(Transmission Control Protocol)를 사용합니다.

  • SOCK_DGRAM 고정된(일반적으로 작은) 최대 길이의 연결되지 않고 신뢰할 수 없는 패킷인 데이터그램을 지원합니다. 인터넷 주소 패밀리에 UDP(사용자 데이터그램 프로토콜)를 사용합니다.

    참고 항목

    멤버 함수는 Accept 새 빈 CSocket 개체를 해당 매개 변수로 참조합니다. 를 호출 Accept하기 전에 이 개체를 생성해야 합니다. 이 소켓 개체가 범위를 벗어나면 연결이 닫힙니다. 이 새 소켓 개체를 호출 Create 하지 마세요.

Important

Create은 스레드로부터 안전하지 않습니다. 여러 스레드에서 동시에 호출할 수 있는 다중 스레드 환경에서 호출하는 경우 각 호출을 뮤텍스 또는 다른 동기화 잠금으로 보호해야 합니다.

스트림 및 데이터그램 소켓에 대한 자세한 내용은 Windows 소켓: 백그라운드 및 Windows 소켓: 포트 및 소켓 주소 및 Windows 소켓 2 API 문서를 참조하세요.

CAsyncSocket::CreateEx

소켓 개체를 CreateEx 생성한 후 멤버 함수를 호출하여 Windows 소켓을 만들고 연결합니다.

소켓 유형과 같은 고급 옵션을 제공해야 하는 경우 이 함수를 사용합니다.

BOOL CreateEx(
    ADDRINFOT* pAI,
    long lEvent = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE);

매개 변수

pAI
패밀리 및 소켓 유형과 같은 소켓 정보를 저장할 포인터 ADDRINFOT 입니다.

lEvent
애플리케이션에 관심이 있는 네트워크 이벤트의 조합을 지정하는 비트 마스크입니다.

  • FD_READ 읽기 준비 상태 알림을 받으려고 합니다.

  • FD_WRITE 쓰기 준비 상태 알림을 받으려고 합니다.

  • FD_OOB 대역 외 데이터의 도착 알림을 받으려고 합니다.

  • FD_ACCEPT 들어오는 연결에 대한 알림을 받으려고 합니다.

  • FD_CONNECT 완료된 연결에 대한 알림을 받으려고 합니다.

  • FD_CLOSE 소켓 닫기 알림을 받으려고 합니다.

Return Value

에 대한 Create()반환 값을 참조하세요.

설명

에 대한 Create()발언을 참조하세요.

CAsyncSocket::Detach

이 멤버 함수를 호출하여 데이터 멤버의 SOCKET 핸들을 m_hSocket 개체에서 분리하고 CAsyncSocket/>로 NULL설정합니다m_hSocket.

SOCKET Detach();

CAsyncSocket::FromHandle

개체에 대한 포인터를 CAsyncSocket 반환합니다.

static CAsyncSocket* PASCAL FromHandle(SOCKET hSocket);

매개 변수

hSocket
소켓에 대한 핸들을 포함합니다.

Return Value

개체에 대한 CAsyncSocket 포인터이거나 NULL 연결된 개체hSocket가 없는 CAsyncSocket 경우.

설명

핸들이 SOCKET 지정되면 개체가 CAsyncSocket 핸들에 연결되지 않으면 멤버 함수가 반환됩니다 NULL.

CAsyncSocket::GetLastError

이 멤버 함수를 호출하여 실패한 마지막 작업에 대한 오류 상태 가져옵니다.

static int PASCAL GetLastError();

Return Value

반환 값은 이 스레드에서 수행한 마지막 Windows 소켓 API 루틴에 대한 오류 코드를 나타냅니다.

설명

특정 멤버 함수가 오류가 발생했음 GetLastError 을 나타내는 경우 적절한 오류 코드를 검색하기 위해 호출해야 합니다. 적용 가능한 오류 코드 목록은 개별 멤버 함수 설명을 참조하세요.

오류 코드에 대한 자세한 내용은 Windows 소켓 2 API를 참조하세요.

CAsyncSocket::GetPeerName

이 멤버 함수를 호출하여 이 소켓이 연결된 피어 소켓의 주소를 가져옵니다.

BOOL GetPeerName(
    CString& rPeerAddress,
    UINT& rPeerPort);

BOOL GetPeerName(
    SOCKADDR* lpSockAddr,
    int* lpSockAddrLen);

매개 변수

rPeerAddress
CString 점선 번호 IP 주소를 받는 개체에 대한 참조입니다.

rPeerPort
포트를 UINT 저장하는 해당 포트에 대한 참조입니다.

lpSockAddr
피어 소켓의 SOCKADDR 이름을 받는 구조체에 대한 포인터입니다.

lpSockAddrLen
주소 길이(바이트)에 lpSockAddr 대한 포인터입니다. 반환할 때 인수에는 lpSockAddrLen 반환된 실제 크기( lpSockAddr 바이트)가 포함됩니다.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEFAULT 인수가 lpSockAddrLen 충분히 크지 않습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 호출이 진행 중입니다.

  • WSAENOTCONN 소켓이 연결되지 않았습니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

설명

IPv6 주소를 CAsyncSocket::GetPeerNameEx처리하려면 .

CAsyncSocket::GetPeerNameEx

이 멤버 함수를 호출하여 이 소켓이 연결된 피어 소켓의 주소를 가져옵니다(IPv6 주소 처리).

BOOL GetPeerNameEx(
    CString& rPeerAddress,
    UINT& rPeerPort);

매개 변수

rPeerAddress
CString 점선 번호 IP 주소를 받는 개체에 대한 참조입니다.

rPeerPort
포트를 UINT 저장하는 해당 포트에 대한 참조입니다.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEFAULT 인수가 lpSockAddrLen 충분히 크지 않습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 호출이 진행 중입니다.

  • WSAENOTCONN 소켓이 연결되지 않았습니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

설명

이 함수는 이전 프로토콜뿐만 아니라 IPv6 주소를 처리한다는 점을 제외하고 동일합니다 CAsyncSocket::GetPeerName .

CAsyncSocket::GetSockName

이 멤버 함수를 호출하여 소켓의 로컬 이름을 가져옵니다.

BOOL GetSockName(
    CString& rSocketAddress,
    UINT& rSocketPort);

BOOL GetSockName(
    SOCKADDR* lpSockAddr,
    int* lpSockAddrLen);

매개 변수

rSocketAddress
CString 점선 번호 IP 주소를 받는 개체에 대한 참조입니다.

rSocketPort
포트를 UINT 저장하는 해당 포트에 대한 참조입니다.

lpSockAddr
소켓의 주소를 받는 구조체에 대한 포인터 SOCKADDR 입니다.

lpSockAddrLen
주소 길이(바이트)에 lpSockAddr 대한 포인터입니다.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEFAULT 인수가 lpSockAddrLen 충분히 크지 않습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAEINVAL 소켓이 .를 사용하는 주소 Bind에 바인딩되지 않았습니다.

설명

이 호출은 첫 번째 호출을 수행 Bind 하지 않고 호출한 경우에 Connect 특히 유용합니다. 이 호출은 시스템에서 설정한 로컬 연결을 확인할 수 있는 유일한 방법을 제공합니다.

IPv6 주소를 처리하려면 CAsyncSocket::GetSockNameEx

CAsyncSocket::GetSockNameEx

이 멤버 함수를 호출하여 소켓의 로컬 이름을 가져옵니다(IPv6 주소 처리).

BOOL GetSockNameEx(
    CString& rSocketAddress,
    UINT& rSocketPort);

매개 변수

rSocketAddress
CString 점선 번호 IP 주소를 받는 개체에 대한 참조입니다.

rSocketPort
포트를 UINT 저장하는 해당 포트에 대한 참조입니다.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEFAULT 인수가 lpSockAddrLen 충분히 크지 않습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAEINVAL 소켓이 .를 사용하는 주소 Bind에 바인딩되지 않았습니다.

설명

이 호출은 IPv6 주소와 이전 프로토콜을 처리한다는 점을 제외하고 동일합니다 CAsyncSocket::GetSockName .

이 호출은 첫 번째 호출을 수행 Bind 하지 않고 호출한 경우에 Connect 특히 유용합니다. 이 호출은 시스템에서 설정한 로컬 연결을 확인할 수 있는 유일한 방법을 제공합니다.

CAsyncSocket::GetSockOpt

소켓 옵션을 검색하려면 이 멤버 함수를 호출합니다.

BOOL GetSockOpt(
    int nOptionName,
    void* lpOptionValue,
    int* lpOptionLen,
    int nLevel = SOL_SOCKET);

매개 변수

nOptionName
값을 검색할 소켓 옵션입니다.

lpOptionValue
요청된 옵션의 값을 반환할 버퍼에 대한 포인터입니다. 선택한 옵션과 연결된 값이 버퍼 lpOptionValue에 반환됩니다. 가리키는 lpOptionLen 정수는 원래 이 버퍼의 크기를 바이트 단위로 포함해야 하며 반환되는 값의 크기로 설정됩니다. 의 경우 SO_LINGER구조체의 LINGER 크기입니다. 다른 모든 옵션의 경우 옵션에 따라 BOOL 또는 intBOOL의 크기가 됩니다. 설명 섹션에서 옵션 및 해당 크기 목록을 참조하세요.

lpOptionLen
버퍼 크기에 lpOptionValue 대한 포인터(바이트)입니다.

nLevel
옵션이 정의된 수준입니다. 지원되는 수준은 다음과 같습니다 SOL_SOCKETIPPROTO_TCP.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 옵션을 설정 SetSockOptGetSockOpt 하지 않은 경우 옵션의 기본값을 반환합니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEFAULTlpOptionLen 인수가 잘못되었습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAENOPROTOOPT 옵션을 알 수 없거나 지원되지 않습니다. 특히 형식 SO_BROADCASTSOCK_STREAM의 소켓에서는 지원되지 않지만 , SO_ACCEPTCONNSO_DONTLINGER, SO_KEEPALIVE, SO_LINGERSO_OOBINLINE 형식SOCK_DGRAM의 소켓에서는 지원되지 않습니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

설명

GetSockOpt 는 모든 형식의 소켓과 연결된 소켓 옵션의 현재 값을 모든 상태로 검색하고 결과를 저장합니다 lpOptionValue. 옵션은 패킷 라우팅, 대역 외 데이터 전송 등과 같은 소켓 작업에 영향을 줍니다.

에 대해 GetSockOpt지원되는 옵션은 다음과 같습니다. 형식은 주소가 지정된 데이터의 형식을 lpOptionValue식별합니다. 옵션은 TCP_NODELAY 수준을 IPPROTO_TCP사용합니다. 다른 모든 옵션은 수준을 SOL_SOCKET사용합니다.

값 유형 의미
SO_ACCEPTCONN BOOL 소켓이 수신 대기하고 있습니다.
SO_BROADCAST BOOL 소켓은 브로드캐스트 메시지의 전송을 위해 구성됩니다.
SO_DEBUG BOOL 디버깅을 사용할 수 있습니다.
SO_DONTLINGER BOOL true이 SO_LINGER 면 옵션을 사용할 수 없습니다.
SO_DONTROUTE BOOL 라우팅을 사용할 수 없습니다.
SO_ERROR int 오류 상태 검색하고 지웁합니다.
SO_KEEPALIVE BOOL Keep-alive가 전송되고 있습니다.
SO_LINGER struct LINGER 현재 느린 옵션을 반환합니다.
SO_OOBINLINE BOOL 대역 외 데이터는 일반 데이터 스트림에서 수신됩니다.
SO_RCVBUF int 수신에 대한 버퍼 크기입니다.
SO_REUSEADDR BOOL 소켓은 이미 사용 중인 주소에 바인딩할 수 있습니다.
SO_SNDBUF int 보내기에 대한 버퍼 크기입니다.
SO_TYPE int 소켓의 형식입니다(예: SOCK_STREAM).
TCP_NODELAY BOOL 보내기 통합을 위해 Nagle 알고리즘을 비활성화합니다.

BSD(Berkeley Software Distribution) 옵션은 다음과 같습니다.GetSockOpt

값 유형 의미
SO_RCVLOWAT int 낮은 워터 마크를 받습니다.
SO_RCVTIMEO int 수신 시간 제한입니다.
SO_SNDLOWAT int 낮은 워터 마크를 보냅니다.
SO_SNDTIMEO int 시간 제한을 보냅니다.
IP_OPTIONS IP 헤더에서 옵션을 가져옵니다.
TCP_MAXSEG int TCP 최대 세그먼트 크기를 가져옵니다.

지원되지 않는 옵션을 사용하여 호출 GetSockOpt 하면 오류 코드 WSAENOPROTOOPT 가 반환 GetLastError됩니다.

CAsyncSocket::IOCtl

소켓의 모드를 제어하려면 이 멤버 함수를 호출합니다.

BOOL IOCtl(
    long lCommand,
    DWORD* lpArgument);

매개 변수

lCommand
소켓에서 수행할 명령입니다.

lpArgument
에 대한 매개 변수에 대한 포인터입니다 lCommand.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEINVALlCommand 가 유효한 명령이 아니거나 lpArgument 허용되는 매개 변수 lCommand가 아니거나 명령이 제공된 소켓 유형에 적용되지 않습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

설명

이 루틴은 모든 상태의 모든 소켓에서 사용할 수 있습니다. 프로토콜 및 통신 하위 시스템에 관계없이 소켓과 연결된 운영 매개 변수를 얻거나 검색하는 데 사용됩니다. 다음 명령이 지원됩니다.

  • FIONBIO 소켓에서 차단 해제 모드를 사용하거나 사용하지 않도록 설정합니다. 매개 변수는 lpArgument 0이 아닌 차단 모드를 사용하도록 설정해야 하는 경우 0이 아닌 값을 가리킵니 DWORD다. 소켓에서 실행된 경우 AsyncSelect 소켓을 다시 차단 모드로 설정하는 데 사용 IOCtl 하려는 시도가 실패합니다 WSAEINVAL. 소켓을 다시 차단 모드로 설정하고 오류를 방지 WSAEINVAL 하려면 먼저 0과 같은 매개 변수를 호출 AsyncSelect 하여 애플리케이션을 lEvent 사용하지 않도록 설정한 AsyncSelect 다음 호출IOCtl해야 합니다.

  • FIONREAD 이 소켓에서 한 번의 Receive 호출로 읽을 수 있는 최대 바이트 수를 결정합니다. 매개 변수는 lpArgument 결과를 저장하는 지점을 가리킵니 DWORDIOCtl 다. 이 소켓이 형식 SOCK_STREAMFIONREAD 인 경우 단일 Receive데이터에서 읽을 수 있는 총 데이터 양을 반환합니다. 일반적으로 소켓에 대기 중인 총 데이터 양과 동일합니다. 이 소켓이 형식 SOCK_DGRAMFIONREAD 이면 소켓에 큐에 대기 중인 첫 번째 데이터그램의 크기를 반환합니다.

  • SIOCATMARK 대역 외 데이터를 모두 읽었는지 여부를 확인합니다. 대역 외 데이터(SO_OOBINLINE)의 인라인 수신을 위해 구성된 형식 SOCK_STREAM 의 소켓에만 적용됩니다. 대역 외 데이터가 읽기를 기다리지 않는 경우 작업은 0이 아닌 값을 반환합니다. 그렇지 않으면 0을 반환하고 소켓에서 수행된 다음 Receive 또는 ReceiveFrom 소켓에서 수행된 데이터는 "mark" 앞에 있는 데이터의 일부 또는 전부를 검색합니다. 애플리케이션은 이 작업을 사용하여 SIOCATMARK 데이터가 다시 기본 여부를 결정해야 합니다. "긴급"(대역 외) 데이터 앞에 일반 데이터가 있는 경우 순서대로 수신됩니다. (동일한 호출에서 Receive 대역 외 데이터와 일반 데이터를 혼합하거나 ReceiveFrom 혼합하지 않습니다.) 매개 변수는 lpArgument 결과를 저장하는 지점을 가리킵니 DWORDIOCtl 다.

이 함수는 Berkeley 소켓에서 사용되는 하위 집합 ioctl() 입니다. 특히 지원되는 유일한 소켓 수준 명령인 반면 SIOCATMARK 에 해당하는 FIOASYNC명령은 없습니다.

CAsyncSocket::Listen

들어오는 연결 요청을 수신 대기하려면 이 멤버 함수를 호출합니다.

BOOL Listen(int nConnectionBacklog = 5);

매개 변수

nConnectionBacklog
보류 중인 연결의 큐가 증가할 수 있는 최대 길이입니다. 유효한 범위는 1에서 5까지입니다.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEADDRINUSE 사용 중인 주소에서 수신 대기하려고 했습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAEINVAL 소켓이 바인딩 Bind 되지 않았거나 이미 연결되어 있습니다.

  • WSAEISCONN 소켓이 이미 연결되어 있습니다.

  • WSAEMFILE 더 이상 파일 설명자를 사용할 수 없습니다.

  • WSAENOBUFS 사용할 수 있는 버퍼 공간이 없습니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAEOPNOTSUPP 참조된 소켓이 작업을 지원하는 형식이 Listen 아닙니다.

설명

연결을 허용하기 위해 소켓이 먼저 만들어 Create지고 들어오는 연결에 대한 백로그가 지정 Listen되고 연결이 수락 Accept됩니다. Listen 는 연결을 지원하는 소켓, 즉 형식 SOCK_STREAM의 소켓에만 적용됩니다. 이 소켓은 들어오는 연결이 승인되고 프로세스에서 수락 대기 중인 대기 중인 "수동" 모드로 전환됩니다.

이 함수는 일반적으로 한 번에 둘 이상의 연결 요청이 있을 수 있는 서버(또는 연결을 수락하려는 애플리케이션)에서 사용됩니다. 연결 요청이 큐가 가득 차면 클라이언트에 오류가 표시됩니다 WSAECONNREFUSED.

Listen 는 사용 가능한 포트(설명자)가 없을 때 합리적으로 계속 작동하려고 시도합니다. 큐가 비워질 때까지 연결을 허용합니다. 포트를 사용할 수 있게 되면 나중에 호출하거나 큐를 Listen 현재 또는 Accept 가장 최근의 "백로그"에 다시 채우고 가능한 경우 들어오는 연결에 대한 수신 대기를 다시 시작합니다.

CAsyncSocket::m_hSocket

이 CAsyncSocket 개체에 SOCKET 의해 캡슐화된 소켓에 대한 핸들을 포함합니다.

SOCKET m_hSocket;

CAsyncSocket::OnAccept

멤버 함수를 호출하여 보류 중인 연결 요청을 수락할 수 있음을 수신 대기 소켓에 알리기 위해 프레임워크에서 Accept 호출합니다.

virtual void OnAccept(int nErrorCode);

매개 변수

nErrorCode
소켓의 가장 최근 오류입니다. 다음 오류 코드는 멤버 함수에 OnAccept 적용됩니다.

  • 0 함수가 성공적으로 실행되었습니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

설명

자세한 내용은 Windows 소켓: 소켓 알림을 참조 하세요.

CAsyncSocket::OnClose

연결된 소켓이 프로세스에 의해 닫혀 있음을 이 소켓에 알리기 위해 프레임워크에서 호출됩니다.

virtual void OnClose(int nErrorCode);

매개 변수

nErrorCode
소켓의 가장 최근 오류입니다. 다음 오류 코드는 멤버 함수에 OnClose 적용됩니다.

  • 0 함수가 성공적으로 실행되었습니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAECONNRESET 원격 쪽에서 연결을 다시 설정했습니다.

  • WSAECONNABORTED 시간 제한 또는 기타 오류로 인해 연결이 중단되었습니다.

설명

자세한 내용은 Windows 소켓: 소켓 알림을 참조 하세요.

CAsyncSocket::OnConnect

성공적으로 또는 오류에 관계없이 연결 시도가 완료되었음을 이 연결 소켓에 알리기 위해 프레임워크에서 호출됩니다.

virtual void OnConnect(int nErrorCode);

매개 변수

nErrorCode
소켓의 가장 최근 오류입니다. 다음 오류 코드는 멤버 함수에 OnConnect 적용됩니다.

  • 0 함수가 성공적으로 실행되었습니다.

  • WSAEADDRINUSE 지정된 주소가 이미 사용 중입니다.

  • WSAEADDRNOTAVAIL 지정된 주소를 로컬 컴퓨터에서 사용할 수 없습니다.

  • WSAEAFNOSUPPORT 지정된 패밀리의 주소는 이 소켓과 함께 사용할 수 없습니다.

  • WSAECONNREFUSED 연결 시도가 강제로 거부되었습니다.

  • WSAEDESTADDRREQ 대상 주소가 필요합니다.

  • WSAEFAULT 인수가 lpSockAddrLen 잘못되었습니다.

  • WSAEINVAL 소켓이 이미 주소에 바인딩되어 있습니다.

  • WSAEISCONN 소켓이 이미 연결되어 있습니다.

  • WSAEMFILE 더 이상 파일 설명자를 사용할 수 없습니다.

  • WSAENETUNREACH 현재 이 호스트에서 네트워크에 연결할 수 없습니다.

  • WSAENOBUFS 사용할 수 있는 버퍼 공간이 없습니다. 소켓을 연결할 수 없습니다.

  • WSAENOTCONN 소켓이 연결되지 않았습니다.

  • WSAENOTSOCK 설명자는 소켓이 아닌 파일입니다.

  • WSAETIMEDOUT 연결을 설정하지 않고 연결 시도 시간이 초과되었습니다.

설명

참고 항목

OnConnect 에서 CSocket알림 함수는 호출되지 않습니다. 연결의 경우 연결이 완료될 때(성공적으로 또는 오류 발생 시) 반환되는 호출 Connect만 하면 됩니다. 연결 알림을 처리하는 방법은 MFC 구현 세부 정보입니다.

자세한 내용은 Windows 소켓: 소켓 알림을 참조 하세요.

예시

void CMyAsyncSocket::OnConnect(int nErrorCode) // CMyAsyncSocket is
                                               // derived from CAsyncSocket
{
   if (0 != nErrorCode)
   {
      switch (nErrorCode)
      {
      case WSAEADDRINUSE:
         AfxMessageBox(_T("The specified address is already in use.\n"));
         break;
      case WSAEADDRNOTAVAIL:
         AfxMessageBox(_T("The specified address is not available from ")
                       _T("the local machine.\n"));
         break;
      case WSAEAFNOSUPPORT:
         AfxMessageBox(_T("Addresses in the specified family cannot be ")
                       _T("used with this socket.\n"));
         break;
      case WSAECONNREFUSED:
         AfxMessageBox(_T("The attempt to connect was forcefully rejected.\n"));
         break;
      case WSAEDESTADDRREQ:
         AfxMessageBox(_T("A destination address is required.\n"));
         break;
      case WSAEFAULT:
         AfxMessageBox(_T("The lpSockAddrLen argument is incorrect.\n"));
         break;
      case WSAEINVAL:
         AfxMessageBox(_T("The socket is already bound to an address.\n"));
         break;
      case WSAEISCONN:
         AfxMessageBox(_T("The socket is already connected.\n"));
         break;
      case WSAEMFILE:
         AfxMessageBox(_T("No more file descriptors are available.\n"));
         break;
      case WSAENETUNREACH:
         AfxMessageBox(_T("The network cannot be reached from this host ")
                       _T("at this time.\n"));
         break;
      case WSAENOBUFS:
         AfxMessageBox(_T("No buffer space is available. The socket ")
                       _T("cannot be connected.\n"));
         break;
      case WSAENOTCONN:
         AfxMessageBox(_T("The socket is not connected.\n"));
         break;
      case WSAENOTSOCK:
         AfxMessageBox(_T("The descriptor is a file, not a socket.\n"));
         break;
      case WSAETIMEDOUT:
         AfxMessageBox(_T("The attempt to connect timed out without ")
                       _T("establishing a connection. \n"));
         break;
      default:
         TCHAR szError[256];
         _stprintf_s(szError, _T("OnConnect error: %d"), nErrorCode);
         AfxMessageBox(szError);
         break;
      }
      AfxMessageBox(_T("Please close the application"));
   }
   CAsyncSocket::OnConnect(nErrorCode);
}

CAsyncSocket::OnOutOfBandData

송신 소켓에 보낼 대역 외 데이터가 있음을 수신 소켓에 알리기 위해 프레임워크에서 호출됩니다.

virtual void OnOutOfBandData(int nErrorCode);

매개 변수

nErrorCode
소켓의 가장 최근 오류입니다. 다음 오류 코드는 멤버 함수에 OnOutOfBandData 적용됩니다.

  • 0 함수가 성공적으로 실행되었습니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

설명

대역 외 데이터는 형식 SOCK_STREAM의 연결된 각 소켓 쌍과 연결된 논리적으로 독립적인 채널입니다. 채널은 일반적으로 긴급 데이터를 보내는 데 사용됩니다.

MFC는 대역 외 데이터를 지원하지만 클래스 CAsyncSocket 사용자는 사용하지 않는 것이 좋습니다. 더 쉬운 방법은 이러한 데이터를 전달하기 위한 두 번째 소켓을 만드는 것입니다. 대역 외 데이터에 대한 자세한 내용은 Windows 소켓: 소켓 알림을 참조 하세요.

CAsyncSocket::OnReceive

멤버 함수를 호출하여 검색할 수 있는 데이터가 버퍼에 있음을 이 소켓에 알리기 위해 프레임워크에서 Receive 호출합니다.

virtual void OnReceive(int nErrorCode);

매개 변수

nErrorCode
소켓의 가장 최근 오류입니다. 다음 오류 코드는 멤버 함수에 OnReceive 적용됩니다.

  • 0 함수가 성공적으로 실행되었습니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

설명

자세한 내용은 Windows 소켓: 소켓 알림을 참조 하세요.

예시

void CMyAsyncSocket::OnReceive(int nErrorCode) // CMyAsyncSocket is
                                               // derived from CAsyncSocket
{
  static int i = 0;

  i++;

  TCHAR buff[4096];
  int nRead;
  nRead = Receive(buff, 4096);

  switch (nRead)
  {
  case 0:
    Close();
    break;
  case SOCKET_ERROR:
    if (GetLastError() != WSAEWOULDBLOCK)
    {
      AfxMessageBox(_T("Error occurred"));
      Close();
    }
    break;
  default:
    buff[nRead] = _T('\0'); //terminate the string
    CString szTemp(buff);
    m_strRecv += szTemp; // m_strRecv is a CString declared
                         // in CMyAsyncSocket
    if (szTemp.CompareNoCase(_T("bye")) == 0)
    {
      ShutDown();
      s_eventDone.SetEvent();
    }
  }
  CAsyncSocket::OnReceive(nErrorCode);
}

CAsyncSocket::OnSend

이제 멤버 함수를 호출하여 데이터를 보낼 수 있음을 소켓에 알리기 위해 프레임워크에서 Send 호출됩니다.

virtual void OnSend(int nErrorCode);

매개 변수

nErrorCode
소켓의 가장 최근 오류입니다. 다음 오류 코드는 멤버 함수에 OnSend 적용됩니다.

  • 0 함수가 성공적으로 실행되었습니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

설명

자세한 내용은 Windows 소켓: 소켓 알림을 참조 하세요.

예시

// CMyAsyncSocket is derived from CAsyncSocket and defines the
// following variables:
//    CString  m_sendBuffer;   //for async send
//    int      m_nBytesSent;
//    int      m_nBytesBufferSize;
void CMyAsyncSocket::OnSend(int nErrorCode)
{
   while (m_nBytesSent < m_nBytesBufferSize)
   {
      int dwBytes;

      if ((dwBytes = Send((LPCTSTR)m_sendBuffer + m_nBytesSent,
                          m_nBytesBufferSize - m_nBytesSent)) == SOCKET_ERROR)
      {
         if (GetLastError() == WSAEWOULDBLOCK)
         {
            break;
         }
         else
         {
            TCHAR szError[256];
            _stprintf_s(szError, _T("Server Socket failed to send: %d"),
                        GetLastError());
            Close();
            AfxMessageBox(szError);
         }
      }
      else
      {
         m_nBytesSent += dwBytes;
      }
   }

   if (m_nBytesSent == m_nBytesBufferSize)
   {
      m_nBytesSent = m_nBytesBufferSize = 0;
      m_sendBuffer = _T("");
   }

   CAsyncSocket::OnSend(nErrorCode);
}

CAsyncSocket::operator =

개체에 새 값을 CAsyncSocket 할당합니다.

void operator=(const CAsyncSocket& rSrc);

매개 변수

rSrc
기존 CAsyncSocket 개체에 대한 참조입니다.

설명

이 함수를 호출하여 기존 CAsyncSocket 개체를 다른 CAsyncSocket 개체에 복사합니다.

CAsyncSocket::operator SOCKET

이 연산자를 사용하여 개체의 핸들을 SOCKET 검색합니다 CAsyncSocket .

operator SOCKET() const;

Return Value

성공하면 개체의 핸들이 SOCKET 고, NULL그렇지 않으면 .

설명

핸들을 사용하여 Windows API를 직접 호출할 수 있습니다.

CAsyncSocket::Receive

소켓에서 데이터를 수신하려면 이 멤버 함수를 호출합니다.

virtual int Receive(
    void* lpBuf,
    int nBufLen,
    int nFlags = 0);

매개 변수

lpBuf
들어오는 데이터에 대한 버퍼입니다.

nBufLen
바이트 단위의 lpBuf 길이입니다.

nFlags
호출이 이루어지는 방식을 지정합니다. 이 함수의 의미 체계는 소켓 옵션 및 매개 변수에 nFlags 의해 결정됩니다. 후자는 다음 값과 C++ 비트 OR 연산자(|)를 결합하여 생성됩니다.

  • MSG_PEEK 들어오는 데이터를 피킹합니다. 데이터는 버퍼에 복사되지만 입력 큐에서 제거되지 않습니다.

  • MSG_OOB 대역 외 데이터를 처리합니다.

Return Value

오류가 발생하지 않으면 수신된 바이트 수를 반환합니다 Receive . 연결이 닫힌 경우 0을 반환합니다. 그렇지 않으면 값 SOCKET_ERROR 이 반환되고 특정 오류 코드를 호출 GetLastError하여 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAENOTCONN 소켓이 연결되지 않았습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAEOPNOTSUPPMSG_OOB 가 지정되었지만 소켓 형식 SOCK_STREAM이 아닙니다.

  • WSAESHUTDOWN소켓이 종료되었습니다. 0 또는 2로 설정된 상태에서 호출된 nHow 후에 ShutDown 는 소켓에서 호출 Receive 할 수 없습니다.

  • WSAEWOULDBLOCK 소켓이 차단 해제로 표시되고 Receive 작업이 차단됩니다.

  • WSAEMSGSIZE 데이터그램이 너무 커서 지정된 버퍼에 맞지 않으며 잘렸습니다.

  • WSAEINVAL 소켓이 .에 Bind바인딩되지 않았습니다.

  • WSAECONNABORTED 시간 제한 또는 기타 오류로 인해 가상 회로가 중단되었습니다.

  • WSAECONNRESET 가상 회로가 원격 쪽에서 다시 설정되었습니다.

설명

이 함수는 연결된 스트림 또는 데이터그램 소켓에 사용되며 들어오는 데이터를 읽는 데 사용됩니다.

유형의 SOCK_STREAM소켓의 경우 제공된 버퍼 크기까지 현재 사용할 수 있는 만큼의 정보가 반환됩니다. 대역 외 데이터(소켓 옵션 SO_OOBINLINE)의 인라인 수신을 위해 소켓이 구성되고 대역 외 데이터가 읽지 않은 경우 대역 외 데이터만 반환됩니다. 애플리케이션은 이 옵션을 사용 IOCtlSIOCATMARK 하거나 OnOutOfBandData 더 이상 대역 외 데이터를 읽을 기본 여부를 결정할 수 있습니다.

데이터그램 소켓의 경우 데이터가 제공된 버퍼의 크기까지 큐에 추가된 첫 번째 데이터그램에서 추출됩니다. 데이터그램이 제공된 버퍼보다 크면 버퍼가 데이터그램의 첫 번째 부분으로 채워지고, 초과 데이터가 손실되고Receive, 오류 코드가 설정된 WSAEMSGSIZE값을 SOCKET_ERROR 반환합니다. 소켓에서 들어오는 데이터를 사용할 수 없는 경우 오류 코드가 로 설정된 WSAEWOULDBLOCK값 SOCKET_ERROR 이 반환됩니다. 콜백 함수를 OnReceive 사용하여 더 많은 데이터가 도착하는 시기를 확인할 수 있습니다.

소켓이 형식 SOCK_STREAM 이고 원격 쪽이 정상적으로 연결을 Receive 종료한 경우 수신된 0바이트로 즉시 완료됩니다. 연결이 다시 설정 Receive 되면 오류가 WSAECONNRESET발생합니다.

Receive 는 호출될 때마다 CAsyncSocket::OnReceive 한 번만 호출되어야 합니다.

예시

에 대한 예제를 CAsyncSocket::OnReceive참조하세요.

CAsyncSocket::ReceiveFrom

이 멤버 함수를 호출하여 데이터그램을 수신하고 원본 주소를 SOCKADDR 구조 또는 에 저장합니다 rSocketAddress.

int ReceiveFrom(
    void* lpBuf,
    int nBufLen,
    CString& rSocketAddress,
    UINT& rSocketPort,
    int nFlags = 0);

int ReceiveFrom(
    void* lpBuf,
    int nBufLen,
    SOCKADDR* lpSockAddr,
    int* lpSockAddrLen,
    int nFlags = 0);

매개 변수

lpBuf
들어오는 데이터에 대한 버퍼입니다.

nBufLen
바이트 단위의 lpBuf 길이입니다.

rSocketAddress
CString 점선 번호 IP 주소를 받는 개체에 대한 참조입니다.

rSocketPort
포트를 UINT 저장하는 해당 포트에 대한 참조입니다.

lpSockAddr
반환 시 원본 주소를 보유하는 구조체에 대한 포인터 SOCKADDR 입니다.

lpSockAddrLen
원본 주소의 길이(바이트)에 lpSockAddr 대한 포인터입니다.

nFlags
호출이 이루어지는 방식을 지정합니다. 이 함수의 의미 체계는 소켓 옵션 및 매개 변수에 nFlags 의해 결정됩니다. 후자는 다음 값과 C++ 비트 OR 연산자(|)를 결합하여 생성됩니다.

  • MSG_PEEK 들어오는 데이터를 피킹합니다. 데이터는 버퍼에 복사되지만 입력 큐에서 제거되지 않습니다.

  • MSG_OOB 대역 외 데이터를 처리합니다.

Return Value

오류가 발생하지 않으면 수신된 바이트 수를 반환합니다 ReceiveFrom . 연결이 닫힌 경우 0을 반환합니다. 그렇지 않으면 값 SOCKET_ERROR 이 반환되고 특정 오류 코드를 호출 GetLastError하여 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEFAULT 인수가 lpSockAddrLen 잘못되었습니다. 버퍼가 lpSockAddr 너무 작아서 피어 주소를 수용할 수 없습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAEINVAL 소켓이 .에 Bind바인딩되지 않았습니다.

  • WSAENOTCONN 소켓이 연결되지 않았습니다(SOCK_STREAM 전용).

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAEOPNOTSUPPMSG_OOB 가 지정되었지만 소켓 형식 SOCK_STREAM이 아닙니다.

  • WSAESHUTDOWN소켓이 종료되었습니다. 0 또는 2로 설정된 상태에서 호출된 nHow 후에 ShutDown 는 소켓에서 호출 ReceiveFrom 할 수 없습니다.

  • WSAEWOULDBLOCK 소켓이 차단 해제로 표시되고 ReceiveFrom 작업이 차단됩니다.

  • WSAEMSGSIZE 데이터그램이 너무 커서 지정된 버퍼에 맞지 않으며 잘렸습니다.

  • WSAECONNABORTED 시간 제한 또는 기타 오류로 인해 가상 회로가 중단되었습니다.

  • WSAECONNRESET 가상 회로가 원격 쪽에서 다시 설정되었습니다.

설명

이 함수는 (연결되었을 수 있음) 소켓에서 들어오는 데이터를 읽고 데이터가 전송된 주소를 캡처하는 데 사용됩니다.

IPv6 주소를 CAsyncSocket::ReceiveFromEx처리하려면 .

유형의 SOCK_STREAM소켓의 경우 제공된 버퍼 크기까지 현재 사용할 수 있는 만큼의 정보가 반환됩니다. 대역 외 데이터(소켓 옵션 SO_OOBINLINE)의 인라인 수신을 위해 소켓이 구성되고 대역 외 데이터가 읽지 않은 경우 대역 외 데이터만 반환됩니다. 애플리케이션은 이 옵션을 사용 IOCtlSIOCATMARK 하거나 OnOutOfBandData 더 이상 대역 외 데이터를 읽을 기본 여부를 결정할 수 있습니다. 소켓의 lpSockAddr 경우 및 lpSockAddrLen 매개 변수가 SOCK_STREAM 무시됩니다.

데이터그램 소켓의 경우 데이터가 제공된 버퍼의 크기까지 큐에 추가된 첫 번째 데이터그램에서 추출됩니다. 데이터그램이 제공된 버퍼보다 크면 버퍼가 메시지의 첫 번째 부분으로 채워지고, 초과 데이터가 손실되고 ReceiveFrom , 오류 코드가 SOCKET_ERROR 설정된 WSAEMSGSIZE값을 반환합니다.

0이 아닌 경우 lpSockAddr 소켓 유형 SOCK_DGRAM이면 데이터를 전송한 소켓의 네트워크 주소가 해당 SOCKADDR 구조에 복사됩니다. 가리키는 lpSockAddrLen 값은 이 구조체의 크기로 초기화되고 반환 시 수정되어 저장된 주소의 실제 크기를 나타냅니다. 소켓에서 들어오는 데이터를 사용할 수 없는 경우 소켓 ReceiveFrom 이 차단되지 않는 한 호출은 데이터가 도착할 때까지 기다립니다. 이 경우 오류 코드가 .로 설정된 WSAEWOULDBLOCK값 SOCKET_ERROR 이 반환됩니다. 콜백을 OnReceive 사용하여 더 많은 데이터가 도착하는 시기를 확인할 수 있습니다.

소켓이 형식 SOCK_STREAM 이고 원격 쪽이 정상적으로 연결을 ReceiveFrom 종료한 경우 수신된 0바이트로 즉시 완료됩니다.

CAsyncSocket::ReceiveFromEx

이 멤버 함수를 호출하여 데이터그램을 수신하고 원본 주소를 SOCKADDR 구조 또는 내(IPv6 주소 처리)에 rSocketAddress 저장합니다.

int ReceiveFromEx(
    void* lpBuf,
    int nBufLen,
    CString& rSocketAddress,
    UINT& rSocketPort,
    int nFlags = 0);

매개 변수

lpBuf
들어오는 데이터에 대한 버퍼입니다.

nBufLen
바이트 단위의 lpBuf 길이입니다.

rSocketAddress
CString 점선 번호 IP 주소를 받는 개체에 대한 참조입니다.

rSocketPort
포트를 UINT 저장하는 해당 포트에 대한 참조입니다.

nFlags
호출이 이루어지는 방식을 지정합니다. 이 함수의 의미 체계는 소켓 옵션 및 매개 변수에 nFlags 의해 결정됩니다. 후자는 다음 값과 C++ 비트 OR 연산자(|)를 결합하여 생성됩니다.

  • MSG_PEEK 들어오는 데이터를 피킹합니다. 데이터는 버퍼에 복사되지만 입력 큐에서 제거되지 않습니다.

  • MSG_OOB 대역 외 데이터를 처리합니다.

Return Value

오류가 발생하지 않으면 수신된 바이트 수를 반환합니다 ReceiveFromEx . 연결이 닫힌 경우 0을 반환합니다. 그렇지 않으면 값 SOCKET_ERROR 이 반환되고 특정 오류 코드를 호출 GetLastError하여 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEFAULT 인수가 lpSockAddrLen 잘못되었습니다. 버퍼가 lpSockAddr 너무 작아서 피어 주소를 수용할 수 없습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAEINVAL 소켓이 .에 Bind바인딩되지 않았습니다.

  • WSAENOTCONN 소켓이 연결되지 않았습니다(SOCK_STREAM 전용).

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAEOPNOTSUPPMSG_OOB 가 지정되었지만 소켓 형식 SOCK_STREAM이 아닙니다.

  • WSAESHUTDOWN소켓이 종료되었습니다. 0 또는 2로 설정된 상태에서 호출된 nHow 후에 ShutDown 는 소켓에서 호출 ReceiveFromEx 할 수 없습니다.

  • WSAEWOULDBLOCK 소켓이 차단 해제로 표시되고 ReceiveFromEx 작업이 차단됩니다.

  • WSAEMSGSIZE 데이터그램이 너무 커서 지정된 버퍼에 맞지 않으며 잘렸습니다.

  • WSAECONNABORTED 시간 제한 또는 기타 오류로 인해 가상 회로가 중단되었습니다.

  • WSAECONNRESET 가상 회로가 원격 쪽에서 다시 설정되었습니다.

설명

이 함수는 (연결되었을 수 있음) 소켓에서 들어오는 데이터를 읽고 데이터가 전송된 주소를 캡처하는 데 사용됩니다.

이 함수는 이전 프로토콜뿐만 아니라 IPv6 주소를 처리한다는 점을 제외하고 동일합니다 CAsyncSocket::ReceiveFrom .

유형의 SOCK_STREAM소켓의 경우 제공된 버퍼 크기까지 현재 사용할 수 있는 만큼의 정보가 반환됩니다. 대역 외 데이터(소켓 옵션 SO_OOBINLINE)의 인라인 수신을 위해 소켓이 구성되고 대역 외 데이터가 읽지 않은 경우 대역 외 데이터만 반환됩니다. 애플리케이션은 이 옵션을 사용 IOCtlSIOCATMARK 하거나 OnOutOfBandData 더 이상 대역 외 데이터를 읽을 기본 여부를 결정할 수 있습니다. 소켓의 lpSockAddr 경우 및 lpSockAddrLen 매개 변수가 SOCK_STREAM 무시됩니다.

데이터그램 소켓의 경우 데이터가 제공된 버퍼의 크기까지 큐에 추가된 첫 번째 데이터그램에서 추출됩니다. 데이터그램이 제공된 버퍼보다 크면 버퍼가 메시지의 첫 번째 부분으로 채워지고, 초과 데이터가 손실되고 ReceiveFromEx , 오류 코드가 SOCKET_ERROR 설정된 WSAEMSGSIZE값을 반환합니다.

0이 아닌 경우 lpSockAddr 소켓 유형 SOCK_DGRAM이면 데이터를 전송한 소켓의 네트워크 주소가 해당 SOCKADDR 구조에 복사됩니다. 가리키는 lpSockAddrLen 값은 이 구조체의 크기로 초기화되고 반환 시 수정되어 저장된 주소의 실제 크기를 나타냅니다. 소켓에서 들어오는 데이터를 사용할 수 없는 경우 소켓 ReceiveFromEx 이 차단되지 않는 한 호출은 데이터가 도착할 때까지 기다립니다. 이 경우 오류 코드가 .로 설정된 WSAEWOULDBLOCK값 SOCKET_ERROR 이 반환됩니다. 콜백을 OnReceive 사용하여 더 많은 데이터가 도착하는 시기를 확인할 수 있습니다.

소켓이 형식 SOCK_STREAM 이고 원격 쪽이 정상적으로 연결을 ReceiveFromEx 종료한 경우 수신된 0바이트로 즉시 완료됩니다.

CAsyncSocket::Send

연결된 소켓에 데이터를 보내려면 이 멤버 함수를 호출합니다.

virtual int Send(
    const void* lpBuf,
    int nBufLen,
    int nFlags = 0);

매개 변수

lpBuf
전송할 데이터를 포함하는 버퍼입니다.

nBufLen
데이터의 길이( lpBuf 바이트)입니다.

nFlags
호출이 이루어지는 방식을 지정합니다. 이 함수의 의미 체계는 소켓 옵션 및 매개 변수에 nFlags 의해 결정됩니다. 후자는 다음 값과 C++ 비트 OR 연산자(|)를 결합하여 생성됩니다.

  • MSG_DONTROUTE 데이터가 라우팅의 대상이 되어서는 안 되도록 지정합니다. Windows 소켓 공급자는 이 플래그를 무시하도록 선택할 수 있습니다.

  • MSG_OOB 대역 외 데이터를 보냅니다(SOCK_STREAM 전용).

Return Value

오류가 발생하지 않으면 전송된 총 문자 수를 반환합니다 Send . (이 값은 .로 표시된 nBufLen숫자보다 작을 수 있습니다.) 그렇지 않으면 값 SOCKET_ERROR 이 반환되고 특정 오류 코드를 호출 GetLastError하여 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEACCES 요청된 주소는 브로드캐스트 주소이지만 적절한 플래그가 설정되지 않았습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAEFAULTlpBuf 인수가 사용자 주소 공간의 유효한 부분에 있지 않습니다.

  • WSAENETRESET Windows 소켓 구현에서 연결을 삭제했기 때문에 연결을 다시 설정해야 합니다.

  • WSAENOBUFS Windows 소켓 구현은 버퍼 교착 상태를 보고합니다.

  • WSAENOTCONN 소켓이 연결되지 않았습니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAEOPNOTSUPPMSG_OOB 가 지정되었지만 소켓 형식 SOCK_STREAM이 아닙니다.

  • WSAESHUTDOWN소켓이 종료되었습니다. 1 또는 2로 설정된 상태에서 호출된 nHow 후에 ShutDown 는 소켓에서 호출 Send 할 수 없습니다.

  • WSAEWOULDBLOCK 소켓이 차단 해제로 표시되고 요청된 작업이 차단됩니다.

  • WSAEMSGSIZE 소켓은 형식 SOCK_DGRAM이며 데이터그램은 Windows 소켓 구현에서 지원하는 최대값보다 큽니다.

  • WSAEINVAL 소켓이 .에 Bind바인딩되지 않았습니다.

  • WSAECONNABORTED 시간 제한 또는 기타 오류로 인해 가상 회로가 중단되었습니다.

  • WSAECONNRESET 가상 회로가 원격 쪽에서 다시 설정되었습니다.

설명

Send 는 연결된 스트림 또는 데이터그램 소켓에 나가는 데이터를 쓰는 데 사용됩니다. 데이터그램 소켓의 경우 기본 서브넷의 최대 IP 패킷 크기를 초과하지 않도록 주의해야 합니다. 이 크기는 반환AfxSocketInit된 구조의 요소에서 WSADATA 지정 iMaxUdpDg 합니다. 데이터가 기본 프로토콜을 통해 원자성으로 전달하기에 너무 길면 오류가 WSAEMSGSIZE 반환 GetLastError되고 데이터가 전송되지 않습니다.

데이터그램 소켓의 Send 경우 성공적으로 완료되었다고 해서 데이터가 성공적으로 배달되었음을 나타내지는 않습니다.

형식SOCK_STREAM의 개체에서 CAsyncSocket 작성된 바이트 수는 로컬 호스트와 외제 호스트의 버퍼 가용성에 따라 1에서 요청된 길이 사이일 수 있습니다.

예시

에 대한 예제를 CAsyncSocket::OnSend참조하세요.

CAsyncSocket::SendTo

특정 대상으로 데이터를 보내려면 이 멤버 함수를 호출합니다.

int SendTo(
    const void* lpBuf,
    int nBufLen,
    UINT nHostPort,
    LPCTSTR lpszHostAddress = NULL,
    int nFlags = 0);

int SendTo(
    const void* lpBuf,
    int nBufLen,
    const SOCKADDR* lpSockAddr,
    int nSockAddrLen,
    int nFlags = 0);

매개 변수

lpBuf
전송할 데이터를 포함하는 버퍼입니다.

nBufLen
데이터의 길이( lpBuf 바이트)입니다.

nHostPort
소켓 애플리케이션을 식별하는 포트입니다.

lpszHostAddress
이 개체가 연결된 소켓의 네트워크 주소: 컴퓨터 이름(예: "ftp.microsoft.com") 또는 점선 번호(예: "128.56.22.8")입니다.

nFlags
호출이 이루어지는 방식을 지정합니다. 이 함수의 의미 체계는 소켓 옵션 및 매개 변수에 nFlags 의해 결정됩니다. 후자는 다음 값과 C++ 비트 OR 연산자(|)를 결합하여 생성됩니다.

  • MSG_DONTROUTE 데이터가 라우팅의 대상이 되어서는 안 되도록 지정합니다. Windows 소켓 공급자는 이 플래그를 무시하도록 선택할 수 있습니다.

  • MSG_OOB 대역 외 데이터를 보냅니다(SOCK_STREAM 전용).

lpSockAddr
대상 소켓의 SOCKADDR 주소를 포함하는 구조체에 대한 포인터입니다.

nSockAddrLen
주소의 길이( lpSockAddr 바이트)입니다.

Return Value

오류가 발생하지 않으면 전송된 총 문자 수를 반환합니다 SendTo . (이 값은 .로 표시된 nBufLen숫자보다 작을 수 있습니다.) 그렇지 않으면 값 SOCKET_ERROR 이 반환되고 특정 오류 코드를 호출 GetLastError하여 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEACCES 요청된 주소는 브로드캐스트 주소이지만 적절한 플래그가 설정되지 않았습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAEFAULTlpBuf 또는 lpSockAddr 매개 변수가 사용자 주소 공간의 일부가 아니거나 인수가 lpSockAddr 너무 작습니다(구조체 SOCKADDR 크기보다 작음).

  • WSAEINVAL 호스트 이름이 잘못되었습니다.

  • WSAENETRESET Windows 소켓 구현에서 연결을 삭제했기 때문에 연결을 다시 설정해야 합니다.

  • WSAENOBUFS Windows 소켓 구현은 버퍼 교착 상태를 보고합니다.

  • WSAENOTCONN 소켓이 연결되지 않았습니다(SOCK_STREAM 전용).

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAEOPNOTSUPPMSG_OOB 가 지정되었지만 소켓 형식 SOCK_STREAM이 아닙니다.

  • WSAESHUTDOWN소켓이 종료되었습니다. 1 또는 2로 설정된 상태에서 호출된 nHow 후에 ShutDown 는 소켓에서 호출 SendTo 할 수 없습니다.

  • WSAEWOULDBLOCK 소켓이 차단 해제로 표시되고 요청된 작업이 차단됩니다.

  • WSAEMSGSIZE 소켓은 형식 SOCK_DGRAM이며 데이터그램은 Windows 소켓 구현에서 지원하는 최대값보다 큽니다.

  • WSAECONNABORTED 시간 제한 또는 기타 오류로 인해 가상 회로가 중단되었습니다.

  • WSAECONNRESET 가상 회로가 원격 쪽에서 다시 설정되었습니다.

  • WSAEADDRNOTAVAIL 지정된 주소를 로컬 컴퓨터에서 사용할 수 없습니다.

  • WSAEAFNOSUPPORT 지정된 패밀리의 주소는 이 소켓과 함께 사용할 수 없습니다.

  • WSAEDESTADDRREQ 대상 주소가 필요합니다.

  • WSAENETUNREACH 현재 이 호스트에서 네트워크에 연결할 수 없습니다.

설명

SendTo 는 데이터그램 또는 스트림 소켓에서 사용되며 소켓에 나가는 데이터를 쓰는 데 사용됩니다. 데이터그램 소켓의 경우 기본 서브넷의 최대 IP 패킷 크기를 초과하지 않도록 주의해야 합니다. 이 크기는 입력한 구조AfxSocketInit의 요소에서 WSADATA 지정 iMaxUdpDg 합니다. 데이터가 기본 프로토콜을 통해 원자성으로 전달하기에 너무 길면 WSAEMSGSIZE 오류가 반환되고 데이터가 전송되지 않습니다.

성공적으로 완료 SendTo 되었다고 해서 데이터가 성공적으로 배달되었음을 의미하지는 않습니다.

SendTo 는 매개 변수로 SOCK_DGRAM 식별되는 특정 소켓에 데이터그램을 보내기 위해 소켓에서 lpSockAddr 만 사용됩니다.

브로드캐스트를 보내려면( SOCK_DGRAM 한 번에) 매개 변수의 lpSockAddr 주소는 의도한 포트 번호와 함께 특수 IP 주소 INADDR_BROADCAST (Windows 소켓 헤더 파일에 WINSOCK.H정의됨)를 사용하여 생성되어야 합니다. 또는 매개 변수가 lpszHostAddress 있으면 NULL소켓이 브로드캐스트용으로 구성됩니다. 일반적으로 브로드캐스트 데이터그램이 조각화가 발생할 수 있는 크기를 초과할 수 없습니다. 이는 데이터그램의 데이터 부분(헤더 제외)이 512바이트를 초과해서는 안 됨을 의미합니다.

IPv6 주소를 CAsyncSocket::SendToEx처리하려면 .

CAsyncSocket::SendToEx

이 멤버 함수를 호출하여 특정 대상으로 데이터를 보냅니다(IPv6 주소 처리).

int SendToEx(
    const void* lpBuf,
    int nBufLen,
    UINT nHostPort,
    LPCTSTR lpszHostAddress = NULL,
    int nFlags = 0);

매개 변수

lpBuf
전송할 데이터를 포함하는 버퍼입니다.

nBufLen
데이터의 길이( lpBuf 바이트)입니다.

nHostPort
소켓 애플리케이션을 식별하는 포트입니다.

lpszHostAddress
이 개체가 연결된 소켓의 네트워크 주소: 컴퓨터 이름(예: "ftp.microsoft.com") 또는 점선 번호(예: "128.56.22.8")입니다.

nFlags
호출이 이루어지는 방식을 지정합니다. 이 함수의 의미 체계는 소켓 옵션 및 매개 변수에 nFlags 의해 결정됩니다. 후자는 다음 값과 C++ 비트 OR 연산자(|)를 결합하여 생성됩니다.

  • MSG_DONTROUTE 데이터가 라우팅의 대상이 되어서는 안 되도록 지정합니다. Windows 소켓 공급자는 이 플래그를 무시하도록 선택할 수 있습니다.

  • MSG_OOB 대역 외 데이터를 보냅니다(SOCK_STREAM 전용).

Return Value

오류가 발생하지 않으면 전송된 총 문자 수를 반환합니다 SendToEx . (이 값은 .로 표시된 nBufLen숫자보다 작을 수 있습니다.) 그렇지 않으면 값 SOCKET_ERROR 이 반환되고 특정 오류 코드를 호출 GetLastError하여 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEACCES 요청된 주소는 브로드캐스트 주소이지만 적절한 플래그가 설정되지 않았습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAEFAULTlpBuf 또는 lpSockAddr 매개 변수가 사용자 주소 공간의 일부가 아니거나 인수가 lpSockAddr 너무 작습니다(구조체 SOCKADDR 크기보다 작음).

  • WSAEINVAL 호스트 이름이 잘못되었습니다.

  • WSAENETRESET Windows 소켓 구현에서 연결을 삭제했기 때문에 연결을 다시 설정해야 합니다.

  • WSAENOBUFS Windows 소켓 구현은 버퍼 교착 상태를 보고합니다.

  • WSAENOTCONN 소켓이 연결되지 않았습니다(SOCK_STREAM 전용).

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

  • WSAEOPNOTSUPPMSG_OOB 가 지정되었지만 소켓 형식 SOCK_STREAM이 아닙니다.

  • WSAESHUTDOWN소켓이 종료되었습니다. 1 또는 2로 설정된 상태에서 호출된 nHow 후에 ShutDown 는 소켓에서 호출 SendToEx 할 수 없습니다.

  • WSAEWOULDBLOCK 소켓이 차단 해제로 표시되고 요청된 작업이 차단됩니다.

  • WSAEMSGSIZE 소켓은 형식 SOCK_DGRAM이며 데이터그램은 Windows 소켓 구현에서 지원하는 최대값보다 큽니다.

  • WSAECONNABORTED 시간 제한 또는 기타 오류로 인해 가상 회로가 중단되었습니다.

  • WSAECONNRESET 가상 회로가 원격 쪽에서 다시 설정되었습니다.

  • WSAEADDRNOTAVAIL 지정된 주소를 로컬 컴퓨터에서 사용할 수 없습니다.

  • WSAEAFNOSUPPORT 지정된 패밀리의 주소는 이 소켓과 함께 사용할 수 없습니다.

  • WSAEDESTADDRREQ 대상 주소가 필요합니다.

  • WSAENETUNREACH 현재 이 호스트에서 네트워크에 연결할 수 없습니다.

설명

이 메서드는 이전 프로토콜뿐만 아니라 IPv6 주소를 처리한다는 점을 제외하고 동일합니다 CAsyncSocket::SendTo .

SendToEx 는 데이터그램 또는 스트림 소켓에서 사용되며 소켓에 나가는 데이터를 쓰는 데 사용됩니다. 데이터그램 소켓의 경우 기본 서브넷의 최대 IP 패킷 크기를 초과하지 않도록 주의해야 합니다. 이 크기는 입력한 구조AfxSocketInit의 요소에서 WSADATA 지정 iMaxUdpDg 합니다. 데이터가 기본 프로토콜을 통해 원자성으로 전달하기에 너무 길면 오류가 WSAEMSGSIZE 반환되고 데이터가 전송되지 않습니다.

성공적으로 완료 SendToEx 되었다고 해서 데이터가 성공적으로 배달되었음을 의미하지는 않습니다.

SendToEx 는 매개 변수로 SOCK_DGRAM 식별되는 특정 소켓에 데이터그램을 보내기 위해 소켓에서 lpSockAddr 만 사용됩니다.

브로드캐스트를 보내려면( SOCK_DGRAM 한 번에) 매개 변수의 lpSockAddr 주소는 의도한 포트 번호와 함께 특수 IP 주소 INADDR_BROADCAST (Windows 소켓 헤더 파일에 WINSOCK.H정의됨)를 사용하여 생성되어야 합니다. 또는 매개 변수가 lpszHostAddress 있으면 NULL소켓이 브로드캐스트용으로 구성됩니다. 일반적으로 브로드캐스트 데이터그램이 조각화가 발생할 수 있는 크기를 초과할 수 없습니다. 이는 데이터그램의 데이터 부분(헤더 제외)이 512바이트를 초과해서는 안 됨을 의미합니다.

CAsyncSocket::SetSockOpt

소켓 옵션을 설정하려면 이 멤버 함수를 호출합니다.

BOOL SetSockOpt(
    int nOptionName,
    const void* lpOptionValue,
    int nOptionLen,
    int nLevel = SOL_SOCKET);

매개 변수

nOptionName
값을 설정할 소켓 옵션입니다.

lpOptionValue
요청된 옵션의 값이 제공되는 버퍼에 대한 포인터입니다.

nOptionLen
버퍼의 lpOptionValue 크기(바이트)입니다.

nLevel
옵션이 정의된 수준입니다. 지원되는 수준은 다음과 같습니다 SOL_SOCKETIPPROTO_TCP.

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEFAULTlpOptionValue 가 프로세스 주소 공간의 유효한 부분에 있지 않습니다.

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAEINVALnLevel 가 유효하지 않거나 정보가 lpOptionValue 올바르지 않습니다.

  • WSAENETRESET커넥트 설정 시 시간이 초과되었습니다SO_KEEPALIVE.

  • WSAENOPROTOOPT 옵션을 알 수 없거나 지원되지 않습니다. 특히 형식 SO_BROADCAST 의 SOCK_STREAM소켓에서는 지원되지 않지만 , SO_DONTLINGER, SO_LINGERSO_KEEPALIVESO_OOBINLINE 형식SOCK_DGRAM의 소켓에서는 지원되지 않습니다.

  • WSAENOTCONN설정되면 커넥트ion이 다시 설정 SO_KEEPALIVE 되었습니다.

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

설명

SetSockOpt 는 모든 상태의 모든 형식의 소켓과 연결된 소켓 옵션의 현재 값을 설정합니다. 옵션은 여러 프로토콜 수준에서 존재할 수 있지만 이 사양은 가장 높은 "소켓" 수준에 있는 옵션만 정의합니다. 옵션은 일반 데이터 스트림에서 신속한 데이터를 받는지 여부, 브로드캐스트 메시지를 소켓에서 보낼 수 있는지 여부 등과 같은 소켓 작업에 영향을 줍니다.

소켓 옵션에는 기능 또는 동작을 사용하거나 사용하지 않도록 설정하는 부울 옵션과 정수 값 또는 구조가 필요한 옵션의 두 가지 유형이 있습니다. 부울 옵션을 lpOptionValue 사용하려면 0이 아닌 정수로 가리킵니다. 옵션을 lpOptionValue 사용하지 않도록 설정하려면 0과 같은 정수로 가리킵니다. nOptionLen 는 부울 옵션의 sizeof(BOOL) 경우와 같아야 합니다. 다른 옵션 lpOptionValue 의 경우 옵션 nOptionLen 에 대해 원하는 값이 들어 있고 정수 또는 구조체의 길이인 정수 또는 구조체를 가리킵니다.

SO_LINGER 는 소켓에서 데이터를 큐에 대기하고 소켓을 닫기 위해 함수를 Close 호출할 때 수행되는 작업을 제어합니다.

기본적으로 소켓은 이미 사용 중인 로컬 주소에 바인딩할 수 없습니다(참조 Bind). 그러나 경우에 따라 이러한 방식으로 주소를 "다시 사용"하는 것이 바람직할 수 있습니다. 모든 연결은 로컬 주소와 원격 주소의 조합으로 고유하게 식별되므로 원격 주소가 다르면 동일한 로컬 주소에 두 개의 소켓을 바인딩하는 데 아무런 문제가 없습니다.

원하는 주소가 Bind 이미 다른 소켓에서 사용 중이므로 소켓에 대한 호출을 허용해서는 안 됨을 Windows 소켓 구현에 알리려면 애플리케이션이 호출을 Bind 실행하기 전에 소켓에 대한 소켓 옵션을 설정 SO_REUSEADDR 해야 합니다. 이 옵션은 호출 시에 Bind 만 해석됩니다. 따라서 기존 주소에 바인딩되지 않는 소켓에서 옵션을 설정하는 것은 불필요하지만 무해하며, 호출이 Bind 이 소켓이나 다른 소켓에 영향을 주지 않으면 옵션을 설정하거나 다시 설정합니다.

애플리케이션은 Windows 소켓 구현에서 소켓 옵션을 켜서 SO_KEEPALIVE TCP(Transmission Control Protocol) 연결에서 "keep-alive" 패킷을 사용하도록 요청할 수 있습니다. Windows 소켓 구현은 keep-alives 사용을 지원할 필요가 없습니다. 이 경우 정확한 의미 체계는 구현에 따라야 하지만 RFC 1122의 섹션 4.2.3.6을 준수해야 합니다. "인터넷 호스트에 대한 요구 사항 - 통신 계층." "keep-alives"의 결과로 연결이 끊어지면 오류 코드 WSAENETRESET 가 소켓에서 진행 중인 모든 호출에 반환되고 후속 호출은 실패합니다 WSAENOTCONN.

이 TCP_NODELAY 옵션은 Nagle 알고리즘을 사용하지 않도록 설정합니다. Nagle 알고리즘은 전체 크기 패킷을 보낼 수 있을 때까지 승인되지 않은 전송 데이터를 버퍼링하여 호스트에서 보내는 작은 패킷 수를 줄이는 데 사용됩니다. 그러나 일부 애플리케이션의 경우 이 알고리즘은 성능을 저해할 수 있으며 TCP_NODELAY 이를 해제하는 데 사용할 수 있습니다. 설정 TCP_NODELAY 이 네트워크 성능에 상당한 부정적인 영향을 미칠 수 있으므로 애플리케이션 작성기는 이러한 작업의 영향을 잘 이해하고 원하는 경우가 아니면 설정 TCP_NODELAY 해서는 안 됩니다. TCP_NODELAY 는 수준을 IPPROTO_TCP사용하는 유일한 지원되는 소켓 옵션입니다. 다른 모든 옵션은 수준을 SOL_SOCKET사용합니다.

Windows 소켓의 일부 구현은 애플리케이션에서 옵션을 설정하는 경우 SO_DEBUG 출력 디버그 정보를 제공합니다.

에 대해 SetSockOpt지원되는 옵션은 다음과 같습니다. 형식은 주소가 지정된 데이터의 형식을 lpOptionValue식별합니다.

값 유형 의미
SO_BROADCAST BOOL 소켓에서 브로드캐스트 메시지의 전송을 허용합니다.
SO_DEBUG BOOL 디버깅 정보를 기록합니다.
SO_DONTLINGER BOOL 보내지 않은 데이터가 전송될 때까지 기다리는 것을 차단 Close 하지 마세요. 이 옵션을 설정하는 것은 0으로 설정된 설정 SO_LINGER 과 l_onoff 동일합니다.
SO_DONTROUTE BOOL 라우팅하지 마세요. 인터페이스로 직접 보냅니다.
SO_KEEPALIVE BOOL keep-alive를 보냅니다.
SO_LINGER struct LINGER Close 전송되지 않은 데이터가 있는 경우 계속 진행합니다.
SO_OOBINLINE BOOL 일반 데이터 스트림에서 대역 외 데이터를 수신합니다.
SO_RCVBUF int 수신에 대한 버퍼 크기를 지정합니다.
SO_REUSEADDR BOOL 소켓이 이미 사용 중인 주소에 바인딩되도록 허용합니다. (참조) Bind.)
SO_SNDBUF int 보내기에 대한 버퍼 크기를 지정합니다.
TCP_NODELAY BOOL 보내기 통합을 위해 Nagle 알고리즘을 비활성화합니다.

BSD(Berkeley Software Distribution) 옵션은 다음과 같습니다.SetSockOpt

값 유형 의미
SO_ACCEPTCONN BOOL 소켓이 수신 대기 중
SO_ERROR int 오류 상태 지우세요.
SO_RCVLOWAT int 낮은 워터 마크를 받습니다.
SO_RCVTIMEO int 수신 시간 제한
SO_SNDLOWAT int 낮은 워터 마크를 보냅니다.
SO_SNDTIMEO int 시간 제한을 보냅니다.
SO_TYPE int 소켓의 유형입니다.
IP_OPTIONS IP 헤더에서 옵션 필드를 설정합니다.

CAsyncSocket::ShutDown

소켓에서 보내기, 수신 또는 둘 다를 사용하지 않도록 설정하려면 이 멤버 함수를 호출합니다.

BOOL ShutDown(int nHow = sends);

매개 변수

nHow
다음 열거형 값을 사용하여 더 이상 허용되지 않는 작업 유형을 설명하는 플래그입니다.

  • receives = 0

  • sends = 1

  • both = 2

Return Value

함수가 성공하면 0이 아닌 경우 그렇지 않으면 0이고, 호출 GetLastError을 통해 특정 오류 코드를 검색할 수 있습니다. 다음 오류가 이 멤버 함수에 적용됩니다.

  • WSANOTINITIALISED 이 API를 사용하기 전에 성공 AfxSocketInit 해야 합니다.

  • WSAENETDOWN Windows 소켓 구현에서 네트워크 하위 시스템이 실패했음을 감지했습니다.

  • WSAEINVALnHow가 잘못된 경우

  • WSAEINPROGRESS 차단 Windows 소켓 작업이 진행 중입니다.

  • WSAENOTCONN 소켓이 연결되지 않았습니다(SOCK_STREAM 전용).

  • WSAENOTSOCK 설명자가 소켓이 아닙니다.

설명

ShutDown 는 수신, 전송 또는 둘 다를 사용하지 않도록 설정하기 위해 모든 유형의 소켓에서 사용됩니다. 0이면 nHow 소켓에서 후속 수신이 허용되지 않습니다. 이는 낮은 프로토콜 계층에 영향을 주지 않습니다.

TCP(Transmission Control Protocol)의 경우 TCP 창은 변경되지 않으며 창이 소진될 때까지 들어오는 데이터가 수락됩니다(승인되지 않음). UDP(사용자 데이터그램 프로토콜)의 경우 들어오는 데이터그램이 허용되고 큐에 대기됩니다. 어떤 경우에도 ICMP 오류 패킷이 생성되지 않습니다. 1이면 nHow 후속 전송이 허용되지 않습니다. TCP 소켓의 경우 FIN이 전송됩니다. 2로 설정 nHow 하면 위에서 설명한 대로 송신과 수신을 모두 사용하지 않도록 설정합니다.

소켓을 ShutDown 닫지 않으며 소켓에 연결된 리소스는 호출될 때까지 Close 해제되지 않습니다. 애플리케이션은 종료된 후 소켓을 다시 사용할 수 있어야 합니다. 특히 이러한 소켓에서의 Connect 사용을 지원하기 위해 Windows 소켓 구현이 필요하지 않습니다.

예시

에 대한 예제를 CAsyncSocket::OnReceive참조하세요.

CASyncSocket::Socket

소켓 핸들을 할당합니다.

BOOL Socket(
    int nSocketType = SOCK_STREAM,
    long lEvent = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE,
    int nProtocolType = 0,
    int nAddressFormat = PF_INET);

매개 변수

nSocketType
또는 .를 지정합니다 SOCK_STREAMSOCK_DGRAM.

lEvent
애플리케이션에 관심이 있는 네트워크 이벤트의 조합을 지정하는 비트 마스크입니다.

  • FD_READ: 읽기 준비 상태 알림을 받으려고 합니다.

  • FD_WRITE: 쓰기 준비 상태 알림을 받으려고 합니다.

  • FD_OOB: 대역 외 데이터의 도착 알림을 받으려고 합니다.

  • FD_ACCEPT: 들어오는 연결에 대한 알림을 받으려고 합니다.

  • FD_CONNECT: 완료된 연결에 대한 알림을 받으려고 합니다.

  • FD_CLOSE: 소켓 닫기 알림을 받으려고 합니다.

nProtocolType
지정된 주소 패밀리와 관련된 소켓과 함께 사용할 프로토콜입니다.

nAddressFormat
주소 패밀리 사양입니다.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

이 메서드는 소켓 핸들을 할당합니다. 소켓을 지정된 주소에 바인딩하기 위해 호출 CAsyncSocket::Bind 하지 않으므로 나중에 호출 Bind 하여 소켓을 지정된 주소에 바인딩해야 합니다. 바인딩되기 전에 소켓 옵션을 설정하는 데 사용할 CAsyncSocket::SetSockOpt 수 있습니다.

참고 항목

CObject 클래스
계층 구조 차트
CSocket 클래스
CSocketFile 클래스