관리 메뉴

ㄴrㅎnㅂrㄹrㄱi

WaitForSingleObject 본문

Ntool Works/작업 참조

WaitForSingleObject

님투 2007. 11. 8. 23:34
반응형

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 이후

반응형

'Ntool Works > 작업 참조' 카테고리의 다른 글

WideCharToMultiByte  (0) 2007.11.08
WaitMessage  (0) 2007.11.08
WaitForMultipleObjects  (0) 2007.11.08
UnmapViewOfFile  (0) 2007.11.08
TrackPopupMenuEx  (0) 2007.11.08
Comments