WaitForSingleObject

WaitForSingleObject

지정된 커넬 오브젝트가 시그널 상태가 되는지, 지정된 시간이 경과할 때까지 스렛드를 sleeve 시킵니다.

DWORD WaitForSingleObject(
    HANDLE hHandle,        // 오브젝트 핸들
    DWORD  dwMilliseconds  // 타임 아웃 시간
);

KERNEL32.DLL

인수

hHandle

오브젝트의 핸들을 지정합니다.

Windows NT/2000/XP： 이 핸들은 SYNCHRONIZE 액세스를 가지고 있지 않으면 안됩니다.

dwMilliseconds

대기 시간을 밀리 세컨드 단위로 지정합니다. 0 (을)를 지정하면, 오브젝트가 시그널 상태인지 어떤지를 조사하자마자 제어를 돌려줍니다. 0xFFFFFFFF (INFINITE) (을)를 지정하면, 오브젝트가 시그널 상태가 될 때까지 무한하게 계속 기다립니다.

반환값

이하의 값의 어느쪽이든을 돌려줍니다.

치	의미
0x00000000 (WAIT_OBJECT_0)	오브젝트가 시그널 상태가 된 것을 나타내 보입니다.
0x00000080 (WAIT_ABANDONED)	방폐되었기 때문에 뮤텍스 오브젝트가 시그널 상태가 된 것을 나타내 보입니다.
0x00000102 (WAIT_TIMEOUT)	타임 아웃 시간이 경과한 것을 나타내 보입니다.
0xFFFFFFFF (WAIT_FAILED)	에러가 발생한 것을 나타내 보입니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

해설

이 함수의 hHandle 파라미터에는, 이하의 커넬 오브젝트의 핸들을 지정할 수 있습니다.

• 파일 변경 통지
• 콘솔 입력
• 이벤트
• 작업
• 뮤텍스
• 프로세스
• semaphore
• 스렛드
• 웨이타브르타이마

대응 정보

Windows 95 이후 / Windows NT 3.1 이후