WSACloseEvent

WSACloseEvent

WSACloseEvent 함수는 개방된 이벤트 객체 핸들을 닫는(close) 함수입니다.

BOOL WSACloseEvent(
WSAEVENT hEvent
);

Parameters

hEvent
[입력] 개방된 이벤트를 식별하는 이벤트 객체 핸들(event object handle)

Remarks

이 함수는 지정된 이벤트 객체 핸들을 닫는 함수입니다. 그렇기 때문에 함수가 성공적으로 수행되고 나서(핸들이 반환되고나서) 이 핸들을 참조하여 어떠한 작업을 하려 하면, WSA_INVALID_HANDLE 이라는 에러코드를 발생하면서 실패하게 됩니다.

Return Values

함수가 성공적으로 수생된다면, TRUE를 반환하고, 그렇지 않다면, FALSE를 반환합니다. 또한, WSAGetLastError 함수를 호출하여 특정한 에러코드를 얻어낼 수 있습니다.

Error Codes

WSANOTINITIALISED	이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다.
WSAENETDOWN	네트웍 서브 시스템에서 에러가 발생했습니다.
WSAEINPROGRESS	블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다.
WSA_INVALID_HANDLE	hEvent 가 올바른 이벤트 객체 핸들이 아닙니다.

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