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