WSARecvEx

WSARecvEx 함수는 flags 매개변수가 입력/출력용 매개변수라는 점을 제외하고는 기존 recv 함수와 같은 기능을 합니다. 데이터그램 프로토콜을 사용해서 전체 메시지가 아닌 일부분만을 수신할 때, flags 매개변수에 MSG_PARTIAL 플래그가 설정되게 됩니다.

int PASCAL FAR WSARecvEx (
        SOCKET  s,
        char FAR*  buf,
        int  len,
        int*  flags
);

Parameters

s
[입력] 접속된 소켓을 식별하는 소켓 기술자

buf
[출력] 들어오는 데이터를 받아낼 버퍼

len
[입력] buf 매개변수의 길이

flags
[입력/출력] 데이터 그램 소켓에서 수신한 메시지가 통째로 수신되었는지 일부분만 수신되었는지를 식별하는 플래그

Remarks

윈도즈 소켓2에서 준비된 함수중 하나인 WSARecvEx 함수는 flags 매개변수가 입/출력 용으로 사용된다는 점을 제외하고는 recv 함수와 유사합니다. recv 함수에서의 flags 는 입력용으로만 사용되었었죠. 암튼, 이 추가적인 출력용 매개변수는 메시지 지향형 프로토콜을 사용할 때 메시지 전체가 수신되었는지 일부분만 수신 되었는지를 알아내는데 사용됩니다. 즉, 기존의 recv 함수는 각각의 recv 함수의 호출로 단일 메시지 만을 수신한데 반해서 WSARecvEx 함수는 지정한 버퍼로 다 담을 수 없을 크기의 메시지도 수신할 수 있다는 기능을 추가 하게된 것입니다.

WSARecvEx 함수는 스트림 지향형 프로토콜 에서는 recv 함수와 똑같이 사용됩니다.

그밖에 msdn에서는 여러 가지 설명을 하고 있는데, 별로 중요한 것 같지 않아서 그만 생략 합니다. 부가적인 정보를 더 원하신다면, msdn을 참고 하시기 바랍니다. 물론 해석은 본인이 부담하셔야죠. ^^

Return Values

에러가 발생하지 않는다면, WSARecvEx 함수는 수신된 바이트의 길이를 반환합니다. 만약 접속이 종료되었다면(close), 0을 반환하게 됩니다. 추가로 몇마디 하자면, 메시지 지향형 프로토콜에서 일부분의 메시지를 수신한 경우 flags 매개변수에서 MSG_PARTIAL 비트는 설정되게 됩니다. 반면, 완전한 메시지가 수신된다면, flags 매개변수에 MSG_PARTIAL 비트는 설정되지 않습니다.

에러가 발생한 경우 SOCKET_ERROR을 반환하게 되고 WSAGetLastError 함수를 이용해서 특정한 에러코드를 얻어낼 수 있습니다.

Error Codes

QuickInfo

Windows NT : 사용가능
Windows CE : 지원하지 않습니다.
Header : mswsock.h.
Import Library : mswsock.lib.

See Also

overview, recvfrom, select, send, socket, WSAAsyncSelect