NtWaitForSingleObject 함수(winternl.h)

아티클
03/13/2024

더 이상 사용되지 않습니다. 지정된 개체가 의 상태가 signaled될 때까지 기다립니다. NtWaitForSingleObject 는 WaitForSingleObject로 대체됩니다.

구문

NTSTATUS NtWaitForSingleObject(
  [in] HANDLE         Handle,
  [in] BOOLEAN        Alertable,
  [in] PLARGE_INTEGER Timeout
);

매개 변수

[in] Handle

대기 개체에 대한 핸들입니다.

[in] Alertable

개체가 대기 중일 때 경고를 전달할 수 있는지 여부를 지정합니다.

TRUE

경고를 전달할 수 있습니다.

FALSE

경고를 전달할 수 없습니다.

[in] Timeout

대기가 발생하는 절대 또는 상대 시간에 대한 포인터입니다. null일 수 있습니다. 시간 제한이 지정되고 개체가 시간 제한이 만료될 때의 signaled 상태를 달성하지 못한 경우 대기가 자동으로 충족됩니다. 명시적 시간 제한 값 0을 지정하면 대기를 즉시 충족할 수 없으면 대기가 발생하지 않습니다.

반환 값

대기 완료 상태. 다양한 NTSTATUS 값은 NTSTATUS에 정의됩니다. H는 Windows DDK와 함께 배포됩니다.

반환 코드	설명
STATUS_SUCCESS	지정된 개체가 대기를 충족했습니다.
STATUS_TIMEOUT	시간 제한이 발생했습니다.
STATUS_ALERTED	현재 스레드에 경고를 전달하기 위해 대기가 중단되었습니다.
STATUS_USER_APC	사용자 APC(비동기 프로시저 호출) 를 현재 스레드에 배달하기 위해 대기가 중단되었습니다.

설명

이 함수에 대한 가져오기 라이브러리가 없으므로 GetProcAddress를 사용해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winternl.h
라이브러리	ntdll.lib
DLL	ntdll.dll

Share via