WaitForMultipleObjects

지정된 하나 또는 모든 객체의 시간 제한 간격이 경과 할때까지 또는 신호 상태로 전활될 때까지 대기한다.

* 이 함수는 다음 객체들에 대해 대기 가능 하다

- Change notification

- Console input

- Event

- Memory resource notification

- Mutex

- Process

- Semaphore

- Thread

- Waitable timer

- 출처 : MSDN

• nCount

- 대기 하려는 객체의 수를 설정한다.

- 최대 객체 수는 MAXIMUM_WAIT_OBJECTS(64)이다.

- 이 파라메터 값은 0이 될 수 없다.

• lpHandles

- 대기 하려는 객체들에 대한 핸들을 담고 있는 배열의 시작 주소를 설정한다.

- 핸들은 SYNCHRONIZE 접근 권한이 설정되어 있어야 한다.

////////////////////////////////////////////////////////////////////////

//                                                                    //

//                             ACCESS TYPES                      //

//                                                                    //

////////////////////////////////////////////////////////////////////////

// begin_wdm

//

//  The following are masks for the predefined standard access types

//

#define DELETE                           (0x00010000L)

#define READ_CONTROL                     (0x00020000L)

#define WRITE_DAC                        (0x00040000L)

#define WRITE_OWNER                      (0x00080000L)

#define SYNCHRONIZE                      (0x00100000L)

#define STANDARD_RIGHTS_REQUIRED         (0x000F0000L)

#define STANDARD_RIGHTS_READ             (READ_CONTROL)

#define STANDARD_RIGHTS_WRITE            (READ_CONTROL)

#define STANDARD_RIGHTS_EXECUTE          (READ_CONTROL)

#define STANDARD_RIGHTS_ALL              (0x001F0000L)

#define SPECIFIC_RIGHTS_ALL              (0x0000FFFFL)

//

// AccessSystemAcl access type

//

#define ACCESS_SYSTEM_SECURITY           (0x01000000L)

//

// MaximumAllowed access type

//

#define MAXIMUM_ALLOWED                  (0x02000000L)

//

//  These are the generic rights.

//

#define GENERIC_READ                     (0x80000000L)

#define GENERIC_WRITE                    (0x40000000L)

#define GENERIC_EXECUTE                  (0x20000000L)

#define GENERIC_ALL                      (0x10000000L)

//

//  Define the generic mapping array.  This is used to denote the

//  mapping of each generic access right to a specific access mask.

//

typedef struct _GENERIC_MAPPING {

    ACCESS_MASK GenericRead;

    ACCESS_MASK GenericWrite;

    ACCESS_MASK GenericExecute;

    ACCESS_MASK GenericAll;

} GENERIC_MAPPING;

typedef GENERIC_MAPPING *PGENERIC_MAPPING;

- 출처 : Winnt.h

• bWaitAll

- TRUE 설정 시 대기하는 모든 객체의 종료 또는 시그널 상태로 전활될 때 반환된다.

- FALSE 설정 시 대기하는 객체들 중 어느 하나의 객체 종료 또는 시그널 상태로 전환될 때 반환된다.

• dwMilliseconds
  

- 밀리 초 단위의 대기 시간 간격을 설정한다.

- 0을 설정 시 바로 반환되며, 0이 아닌 시간을 입력 했을 시 지정한 시간만큼을 대기한다.

- 값을 INFINITE로 설정 시 지정 객체의 종료 또는 시그널 상태로 전환될 때 반환된다.

Return value : 성공 시 WAIT_ABANDONED_0~nCount-1(0x00000080L+nCount-1), WAIT_OBJECT_0~nCount-1(0x00000000L+nCount-1), WAIT_TIMEOUT(0x00000102L)를 반환하고, 실패 시 WAIT_FAILED(0xFFFFFFFF)를 반환한다.

 - WAIT_ABANDONED : 뮤텍스 객체 사용 시 발생

 - WAIT_OBJECT_0 : 대기 하고 있는 객체의 종료 또는 시그널 상태로 전환 시 발생

 - WAIT_TIMEOUT : 대기 시간 초과 시 발생

Header : WinBase.h(include Windows.h)

DLL : Kernel32.dll