shutdown
shutdown 함수는 소켓에서의 송신이나 수신을 비활성화 하는데 사용하는 함수입니다.
int shutdown (
SOCKET s,
int how
);
Parameters
s
[입력]
대상 소켓의 기술자(descriptor)를 명시합니다.
how
[입력]
셧다운될 오퍼레이션의 타입을 지정합니다.
Remarks
shutdown 함수는 수신, 전송, 또는 양쪽모두 비활성화 시키기 위해 사용됩니다.
how 매개변수가
SD_RECEIVE 이면, 나중에 호출될 recv 함수는 아무런 작동을 하지 않게 됩니다.
how
매개변수가 SD_SEND 라면, 나중에 호출될 send 함수는 비활성화 됩니다. 전송큐에
남아있는 데이터는 모두 전송됩니다.
how
매개변수가 SD_BOTH 라면, 전송과 수신 모두다 비활성화 됩니다.
shutdown 함수는 소켓을 닫지 않습니다. 그러므로 closesocket 함수가 해당 소켓에서 호출될 때까지 자원은 비워지지 않습니다.
소켓이 닫히기전에 모든 데이터를 보내고, 수신하도록 확실히 하기 위해서 어플리케이션은 closesocket 함수를 호출하기전에 shutdown 함수를 호출하여 접속을 해제 합니다. 우아한 접속종료를 하는 방법이 아래에 소개되어 있습니다. 참고하세요.
1. FD_CLOSE 이벤트를 등록하기 위해서 WSAAsyncSelect 함수를 호출합니다.
2. how=SD_SEND 로 shutdown 함수를 호출합니다.
3. FD_CLOSE 이벤트를 받았을 때 recv 함수를 0이 반환될 때 까지 또는 SOCKET_ERROR 가 반환 될 때 까지 호출합니다.
4. 자~ 이제 마지막으로 closesocket 함수를 호출 합니다.
Return Values
아무런 에러가 발생하지 않으면, shutdown 함수는 0을 반환 합니다. 에러가 발생한 경우는 SOCKET_ERROR 값이 반환 됩니다. 그리고 WSAGetLastError 함수를 이용해서 특정한 에러코드를 받을 수 있습니다.
Error Codes
| WSANOTINITIALISED | 이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다. |
| WSAENETDOWN | 네트웍 서브 시스템에 에러가 발생했습니다. |
| WSAEINVAL | how 매개변수가 잘못된 값입니다. |
| WSAEINPROGRESS | 블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다. |
| WSAENOTCONN | 소켓이 접속된 상태가 아닙니다.(접속지향 소켓(connection-oriented sockets) 에서만) |
| WSAENOTSOCK | 기술자(descriptor)가 소켓이 아닙니다. |
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
See Also