WSACreateEvent

WSACreateEvent

WSACreateEvent 함수는 새로운 이벤트 객체를 생성하는 함수 입니다.

WSAEVENT WSACreateEvent( void );

Remarks

WSACreateEvent 함수는 신호받지 않은 초기상태를 직접 리셋하여 생성한 이벤트 객체를 생성하는데 사용됩니다. 윈소2 이벤트 객체는 Win32 환경의 시스템 객체입니다. 따라서, Win32 어플리케이션이 자동 리셋 이벤트(auto reset events)를 원한다면, 이 함수를 직접 수행하면 됩니다. 이벤트 객체의 범위(스코프)는 객체가 생성된 프로세스로 제한됩니다.

Return Values

함수가 성공적으로 수행된 경우 WSACreateEvent 함수는 이벤트 객체의 핸들을 반환 합니다. 반면, 실패한 경우 반환값은 WSA_INVALID_EVENT를 가집니다. 그리구, WSAGetLastError 함수를 호출하여 특정한 에러코드를 얻어낼 수 있습니다.

Error Codes

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

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