code toolbox

HANDLE CreateEvent(LPSECURITY_ATTRIBUTES lpEventAttributes, BOOL bManualReset, 
BOOL bInitialState, LPCTSTR lpName); 

HANDLE OpenEvent(DWORD dwDesiredAccess, BOOL bInheritHandle, LPCTSTR lpName); 

bManualReset은 이벤트가 수동리셋 이벤트(manual)인지 자동리셋 이벤트(automatic)인지 지정하는데 TRUE이면 수동리셋 이벤트가 된다. 
bInitialState가 TRUE이면 이벤트를 생성함과 동시에 신호상태로 만들어 이벤트를 기다리는 쓰레드가 곧바로 실행을 하도록 해준다. 
이벤트도 이름(lpName)을 가지므로 프로세스간의 동기화에 사용될 수 있다. 

또한 이벤트가 임계영역이나 뮤텍스와 다른점은 
대기함수를 사용하지 않고도, 쓰레드에서 임의적으로 신호상태와 비신호상태를 설정할 수 있다는 점이다. 다음 함수를 사용한다. 

BOOL SetEvent(HANDLE hEvent); 
BOOL ResetEvent(HANDLE hEvent);

1. 함수의 원형

    HANDLE WINAPI CreateEvent(LPSECURITY_ATTRIBUTES lpEventAttributes, 
                                          BOOL bManualReset, BOOL bInitialState, LPCTSTR lpName);

2. 함수의 기능
 
    이름이 정해진 또는 이름이 없는 이벤트 객체를 열거나 생성하는 함수이다. 이 객체에
    접근할수 있는 경우를 명시하고 싶다면 CreateEventEx 함수를 사용해야 한다.
   

3. 함수의 매개변수에 대한 설명
 
    3.1 lpEventAttributes
        
        SECURITY_ATTRIBUTES 구조체로 선언된 변수의 주소를 명시한다. 이 매개변수에 NULL을 명시하면 
        생성된 이벤트 핸들은 자식 프로세스에 상속되지 않는다. SECURITY_ATTRIBUTES 구조체의 항목인
        lpSecurityDescript-xor에는 새로운 이벤트의 보안 기술자(security descript-xor)에 대하여 명시하도록 되어있다.
        만약, 이 매개변수에 NULL을 사용하여 보안 기술자에 대한 명시를 하지 않은 경우에는, 새로 생성될
        이벤트 객체에 일반적인 보안 기술자가 명시된걸로 간주한다. 일반적인 보안 기술자의
        ACL(Access Control List)은 현재 로그인되어 있는 사용자의 로그인정보에 있는 ACL을 이용하거나 
        이벤트 객체를 생성한 프로세스의 ACL을 가져와 사용한다.

        ACL에 대한 좀더 자세한 내용은 아래의 항목을 참고하시기 바랍니다.
        http://www.tipssoft.com/bulletin/tb.php/FAQ/15

    3.2 bManualReset
 
        이 매개변수에 TRUE를 명시하면 발생된 이벤트 정보가 계속 유지되는 이벤트 객체를 생성한다. 
        즉, 이벤트 객체에 SetEvent 함수를 이용하여 이벤트를 설정하면 ResetEvent 함수를 호출하여
        해제하기 전까지 계속 이벤트가 발생한 상태로 유지된다.

        반대로 이 매개변수에 FALSE를 명시하면 자동으로 이벤트가 해제되는 이벤트 객체를 생성한다.
        즉, 이벤트를 기다리는 스레드가 이벤트가 발생한 상황을 체크하게 되면 자동으로 이벤트
        정보가 해제된다. 따라서 별도의 ResetEvent 함수를 호출할 필요가 없다.
 
    3.3 bInitialState
 
        이 매개변수가 TRUE라면 이벤트 객체는 이벤트가 발생한 상태로 생성되며 FALSE이면 이벤트가
        발생하지 않은 상태로 생성된다.
 
    3.4 lpName
 
        이 매개변수에는 이벤트 객체에 사용할 이름을 명시한다. 여기에 사용되는 이름의 길이는
        MAX_PATH까지로 제한되며 대소문자를 구별(Tips, tips, tipS는 서로 다른걸로 간주)한다.
        만약, 명시한 이름이 이미 생성된 다른 이벤트 객체에 사용되고 있다면 이미 생성된 객체와
        이벤트 발생정보를 공유하게 된다. 따라서 먼저 만들어진 이벤트 객체의 정보가 우선시
        되기 때문에 현재 사용한 bManualReset(3.2), bInitialState(3.3)에 명시한 정보는 무시된다.
        그리고 lpEventAttributes(3.1)에 NULL이 아닌 보안정보가 명시된 경우, 먼저 생성된 
        이벤트 객체의 보안 기술자에 의해서 사용되어질것인지 결정되며 사용가능하다고
        판단되더라도 해당 구조체의 세부항목인 보안기술자 항목에 명시된 정보는 무시된다.
        따라서 고유한 이벤트 객체를 생성하려면 이벤트 이름을 명시할때 주의해야 한다.

        만약, 이 매개변수에 명시한 이름이 이미 생성된 Semaphore, Mutex, Waitable timer, Job 
        또는 File-mapping 객체에 사용되고 있다면 이 함수는 실패할것이고 정확한 오류체크를
        위해 GetLastError 함수를 호출하면 ERROR_INVALID_HANDLE 값이 반환될 것이다. 
        즉, 하나의 객체는 다른 형식의 객체와 이름을 공유할수 없고 동일한 형식의 객체에서만
        공유여부가 결정되어진다.

        이 매개변수에 NULL을 명시하면 이름없는 이벤트 객체를 생성한다.
        
        추가적으로 객체의 이름을 명시할때, 시스템 전역적으로 객체의 이름을 공유하고 싶다면 
        사용하고자 하는 이름앞에 "Global\"이라는 접두어를 사용하고 현재 세션공간에서만
        사용하고 싶을때에는 "Local\"이라는 접두어를 사용할수 있다.

        "Global" 또는  "Local" 이라는 접두어를 사용할수 있는 커널 객체에 대해서 좀더 자세한 
        내용을 원하신다면 아래 내용을 참고하시기 바랍니다.

        ( Kernal Objcet Namespace ) -http://www.tipssoft.com/bulletin/tb.php/FAQ/17

        그리고 사적인 이름공간에도 이벤트 객체를 생성할수 있는데 이방법에 대해서 좀더
         자세한 내용을 원하신다면 아래 내용을 참고하시기 바랍니다.
         [ Object Namespaces ] - http://www.tipssoft.com/bulletin/tb.php/FAQ/18

4. 함수의 반환값
    
    이 함수가 성공적으로 수행을 완료했다면 생성된 이벤트 객체의 핸들이 반환될 것이다. 만약,
    lpName에 사용한 이름과 동일한 이름으로 생성된 이벤트 객체가 이미 생성되어 있다면
    해당 객체의 핸들이 반환될것이다. 이때, GetLastError 함수를 호출해보면 
    ERROR_ALREADY_EXISTS가 반환될 것이다. 따라서 다른 프로세스와 이벤트 객체가
    공유되는것을 원치 않는다면 CreateEvent 함수가 정상적인 이벤트 핸들값을 반환하더라도
    GetLastError 함수를 호출하여 ERROR_ALREADY_EXISTS 값이 반환되는지를 체크하는것도
    좋은 방법일 것이다.

    만약 함수가 실패한다면 NULL값이 반환될 것이고, GetLastError 함수를 호출해서 좀더 자세한 
    오류 상황을 확인할 수 있다.