WSAEnumNetworkEvents

WSAEnumNetworkEvent 함수는 지정된 소켓에 대한 네트웍 이벤트의 발생을 알아내고, 내부 네트웍 이벤트 레코드를 클리어 하고, 이벤트 객체를 리셋하는 함수 입니다.

int WSAEnumNetworkEvents (
        SOCKET                          s,
        WSAEVENT                      hEventObject,
        LPWSANETWORKEVENTS lpNetworkEvents
);

 

Parameters

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

hEventObject
[입력] 리셋하기 위한 이벤트 객체를 명시하는 핸들 입니다.

lpNetworkEvents
[출력] WSANETWORKEVENTS 구조체의 포인터입니다. 이 구조체는 발생된 네트웍 이벤트와 관련된 에러코드로 구성되어 있습니다.

 

Remarks

WSAEnumNetworkEvents 함수는 이 함수를 호출하기 바로 전까지 지정된 소켓 s 에 대해서 발생된 네트웍 이벤트를 알아내는데 사용되는 함수입니다. 이 함수는 WSAEventSelect 함수와 같이 사용한다고 생각하면 됩니다.

WSAEnumNetworkEvents 함수는 네트웍 동작과 WSAEventSelect 함수로 지정된 에러를 레포팅 합니다. 이러한 함수가 어떻게 네트웍 동작과 에러를 찾아내는지 알아보려면, select 와 WSAAsyncSelect 함수의 명세를 보시기 바랍니다.

소켓의 네트웍 이벤트 내부 기록은 lpNetworkEvents 매개변수에 의해서 참조된 구조체로 복사되고, 내부 네트웍 이벤트 기록이 있는 곳은 클리어 됩니다. hEventObject 매개변수가 NULL 이 아니라면, 발생한 이벤트 객체는 또한 리셋됩니다. 윈도즈 소켓 프로바이더는 네트웍 이벤트 기록을 복사하는 작업과, 이 기록을 클리어 하는 것 그리고, 관련된 이벤트 객체를 리셋하는 책임을 집니다. 다음으로 발생되는 등록된 네트웍 이벤트는 이벤트 객체를 설정되도록 할 것입니다. 함수가 SOCKET_ERROR를 반환하는 경우에는 관련된 이벤트 객체가 리셋되지 않고, 네트웍 이벤트의 기록이 클리어 되지 않습니다.

WSANETWORKEVENTS 구조체의 INetworkEvents 멤버는 FD_XXX 계열의 네트웍 이벤트가 발생됨을 암시합니다. iErrorCode 배열은 INetworkEvents 의 이벤트 비트의 위치와 부합하는 배열 인덱스로 관련된 에러코드를 포함하는데 사용됩니다. FD_READ_BIT와 FD_WRITE_BIT 와 같은 식별자는 iErrorCode 배열의 인덱스로 사용될 수 있습니다.  이러한 iErrorCode 배열의 요소들 만이 INetworkEvents 필드에 설정될 수 있다는 것을 명심하십시요. 다른 필드들은 수정되는 않되는 필드들입니다.

아래의 에러코드는 일치하는 네트웍 이벤트에 따라서 반환될 수 있습니다.

Event: FD_CONNECT

Error Code Meaning
WSAEAFNOSUPPORT 지정된 패밀리(family)인 어드레스가 이 소켓에 대해서 사용될 수 없습니다.
WSAECONNREFUSED 접속시도가 강제적으로 리젝트(reject) 되었습니다.
WSAENETUNREACH 네트웍이 현재 호스트로부터 도달할 수 없는 상태입니다.
WSAENOBUFS 사용할 수 있는 버퍼 공간이 없습니다. 소켓은 접속될 수 없습니다.
WSAETIMEDOUT 접소시도가 접속이 이루어지지 않은 상태에서 타임아웃 되었습니다.

Event: FD_CLOSE

Error Code Meaning
WSAENETDOWN 네트웍 서브 시스템에서 에러가 발생 했습니다.
WSAECONNRESET 접속이 원격지 단말에서 리셋되었습니다.
WSAECONNABORTED 접속이 타임아웃이나 다른 에러로 인하여 종료되었습니다.

Event: FD_READ

Event: FD_WRITE

Event: FD_OOB

Event: FD_ACCEPT

Event: FD_QOS

Event: FD_GROUP_QOS

Event: FD_ADDRESS_LIST_CHANGE

Error Code Meaning
WSAENETDOWN 네트웍 서브 시스템에서 에러가 발생 했습니다.

Event: FD_ROUTING_INTERFACE_CHANGE

Error Code Meaning
WSAENETUNREACH 지정한 목적지에 더 이상 도달 할 수 없습니다.
WSAENETDOWN 네트웍 서브 시스템에서 에러가 발생했습니다.

 

Return Values

작업이 성공적으로 수행된 경우 0을 반환 합니다. 에러가 발생한 경우 SOCKET_ERROR을 반환 하면, WSAGetLastError 함수를 호출하여 특정한 에러코드를 얻어낼 수 있습니다.

 

Error Codes

WSANOTINITIALISED

이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다.

WSAENETDOWN 네트웍 서브 시스템에서 에러가 발생했습니다.
WSAEINVAL 지정된 매개변수중에 하나가 올바른 값이 아닙니다.
WSAEINPROGRESS 블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다.
WSAENOTSOCK 지정된 기술자가 소켓 기술자가 아닙니다.
WSAEFAULT lpNetworkEvents 매개변수가 제대로 할당받은 메모리 공간이 아닙니다.

 

QuickInfo

Windows NT : 사용가능
Windows : 사용가능
Windows CE : 지원하지 않음
Header :
          Win16/32 : winsock.h
          Win32-II : winsock2.h
Import Library :
          Win16 : winsock.lib
          Win32 : wsock32.lib
          Win32-II : ws2_32.lib

See Also

overview, WSAEventSelect