recvfrom

recvfrom

recvfrom 함수는 소켓으로부터 데이터그램을 수신하고, 관련된 어드레스 및 포트 번호를 반환 하는 함수입니다.

int recvfrom (
        SOCKET   s,
        char FAR*   buf,
        int   len,
        int   flags,
        struct sockaddr FAR*   from,
        int FAR*   fromlen
);

Parameters

s
[입력] 바인드된 소켓을 기술하는 식별자(descriptor)입니다.

buf
[출력] 수신되는 데이터를 복사할 버퍼입니다.

len
[입력] 버퍼의 길이

flags
[입력] 함수의 호출로 어떤 작업을 할 건지 명시하는 플래그입니다.

from
[출력] 수신받은 데이터를 송신한 단말의 어드레스를 리턴받기 위한 버퍼 포인터입니다.

fromlen
[입/출력] from 버퍼의 사이즈를 위한 포인터 입니다.

Remarks

recvfrom 함수는 접속된 소켓과 접속되지 않은 소켓에서 수신되는 데이터를 읽고 데이터를 보낸곳의 주소를 얻어내는 함수입니다. 이 함수를 사용하기 전에 소켓의 로컬 어드레스를 알아야 하는데, 서버 어플리케이션에서는 명시적인 bind 함수를 사용해서 알아냅니다. 이러한 명시적인(explicit) 바인딩은 클라이언트 어플리케이션에서 사용 했을 때 좋지 않은 결과를 낼 수 있습니다. 이 함수를 사용하는 클라이언트 어프리케이션은 sendto, WSASendTo 또는 WSAJoinLeaf 함수를 이용해서 묵시적으로 로컬 어드레스를 바인드 할 수 있습니다.

SOCK_STREAM 형태와 같은 스트림 소켓(stream oriented sockets)에서 recvfrom 함수는 이용가능한 많은 정보를 반환 할 것입니다. 만약 아직 읽혀지지 않은 out-of-band 데이터가 남아있고, 소켓이 out-of-band 데이터의 인라인 수신을 할 수 있다면(이럴 경우 소켓 옵션이 SO_OOBINLINE 으로 설정되어 있어야겠죠?) out-of-band 데이터는 읽혀질 것입니다. 어플리케이션은 더 읽기위해 남아있는 out-of-band 데이터가 있는지 없는지 확인하기 위해 ioctlsocket이나 WSAIoctl 의 SIOCATMARK 컴맨드를 사용할 수 있습니다.

메시지 지향형 소켓(message-oriented sockets))일 경우 데이터는 첫 번째로 저장된 메시지를 버퍼크기 만큼 읽어냅니다. 데이터 그램이나 메시지가 지정된 버퍼 크기보다 더 클 경우에는 데이터그램의 첫 번째 부분부터 채워지고, recvfrom 함수는 WSAEMSGSIZE 라는 에러코드를 발생시킵니다. UDP 와 같이 데이터의 신뢰성을 보장할 수 없는 프로토콜의 경우 초과된 데이터는 손실되게 됩니다.

만약 from 매개변수가 0이 아니고, 소켓이 접속지향형이 아니라면, 데이터를 보낸 상대방(peer)의 네트웍 어드레스는 SOCKADDR 구조체인 from에 저장됩니다. fromlen 매개변수는 SOCKADDR 구조체의 크기를 건네주게 되고, 반환 할 때는 SOCKADDR 구조체에 저장된 실제 어드레스 크기를 되돌립니다.

만약 수신할 데이터가 없게되면, recvfrom 함수는 수신할 데이터가 들어 올 때까지 블록킹 상태에 걸립니다.

소켓이 접속지향형(connected oriented) 이고 원격지 지점에서 접속이 셧다운(우아한(gracefully) 종료) 되어 버린 상태라면, recvfrom 함수는 데이터를 하나도 받지 못한 상태에서 동작을 완료합니다. 접속이 리셋 되어 버린 경우엔 WSAECONNRESET 이라는 에러코드를 발생하며 함수의 수행은 실패 하게 됩니다.

flag 매개변수는 recvfrom 함수가 기본적으로 수행하는 수신된 데이터를 일고 수신큐에서 제거하는 일 이외의 원하는 다른 처리를 할 수 있도록 하는 플래그입니다. 이 플래그에는 아래와 같은 값이 사용됩니다.

Value	Meaning
MSG_PEEK	MSG_PEEK 플래그는 수신큐에 있는 데이터를 읽기만 하는 작업을 하게 합니다. 데이터는 단지 읽어서 특정한 버퍼로 복사가 가능하지만, 수신 큐에 있는 데이터를 제거하지는 않습니다.
MSG_OOB	MSG_OOB 플래그는 out-of-band 데이터의 처리에 사용됩니다.

Return Values

에러가 발생하지 않으면, recvfrom 함수는 읽혀진 데이터의 바이트 수를 반환 합니다. 만약 접속이 종료(gracefully closed) 되었다면, 0을 반환 하게 됩니다. 에러가 발생한 경우 SOCK_ERROR 값이 반환 되며, WSAGetLastError 함수를 이용해 특정한 에러 코드를 얻을 수 있습니다.

Error Codes

WSANOTINITIALISED	이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다.
WSAENETDOWN	네트웍 서브 시스템에 에러가 발생했습니다.
WSAEFAULT	buf 매개변수가 제대로 된 형태가 아닙니다.
WSAEINTR	블록킹 호출이 WSACancelBlockingCall 함수에서 취소되었습니다.
WSAEINPROGRESS	블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다.
WSAEINVAL	소켓이 bind 함수에 의해서 바인드 되지 않았거나, 알 수 없는 플래그가 사용되었거나, SO_OOBINLINE 옵션을 가능하게 한 상태 에서 MSG_OOB 플래그가 소켓에 대해서 명시되었습니다. 또는 len 매개변수가 0 이거나 0보다 작습니다.
WSAEISCONN	소켓이 접속되어 있습니다. 이 함수는 접속 지향형 소켓이건 비접속 지향형 소켓이건간에 접속되어 있는 소켓을 허용 하지 않습니다. (아!!! 정말 돌아 버리겠습니다... 분명, 위의 remark 에서는 "접속된 소켓과 접속되지 않은 소켓에서 수신되는 데이터를 읽고 데이터를 보낸곳의 주소를 얻어내는 함수입니다." 라고 설명 해 놓고 이제와서 허용하지 않는다니... 이게 무슨 마른 하늘에 날벼락 이란 말입니까... 된다는 말인지 안 된다는 말인지 쪄비~ ㅠㅠ 원문을 첨가 하겠습니다. ) The socket is connected. This function is not permitted with a connected socket, whether the socket is connection-oriented or connectionless.
WSAENETRESET	T연산이 진행되고 있는 도중 접속이 끊겨버렸습니다.
WSAENOTSOCK	기술자(descriptor)가 소켓이 아닙니다.
WSAEOPNOTSUPP	MSG_OOB 가 명시되었지만, 소켓은 SOCK_STREAM 과 같은 형태의 스트림 형태가 아닙니다.
WSAESHUTDOWN	소켓이 셧다운 되었습니다.
WSAEWOULDBLOCK	소켓이 넌블록킹(비동기)로 마킹되어 있고, 수신 연산이 내부적으로 아직 기다림 상태입니다.
WSAEMSGSIZE	수신된 메시지가 지정된 버퍼에 저장하기에 너무 커서 손실 되었습니다.
WSAETIMEDOUT	접속이 네트웍 실패나 상대방 시스템의 응답 실패로 인하여 드랍 되어 버렸습니다.
WSAECONNRESET	가상 회로망이 원격지에서 "hard"나 "abortive" 종료를 수행해서 리셋되었습니다.

QuickInfo

Windows NT : 사용가능
Windows : 사용가능
Windows CE : 버젼 1.0 그리고 그이후의 버젼에서 사용가능
Header :
          Win16/32 : winsock.h
          Win32-II : winsock2.h
Import Library :
         Win16 : winsock.lib
          Win32 : wsock32.lib
          Win32-II : ws2_32.lib