通过

NtWaitForSingleObject 函数 (winternl.h)

  • 项目

已弃用。 等待，直到指定的 对象达到 状态 signaled。 NtWaitForSingleObject 由 WaitForSingleObject 取代。

语法

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

参数

[in] Handle

wait 对象的句柄。

[in] Alertable

指定在对象正在等待时是否可以传递警报。

TRUE

可以传递警报。

FALSE

无法传递警报。

[in] Timeout

指向等待时间的绝对时间或相对时间的指针。 可以为 null。 如果指定了超时，并且对象在超时到期时尚未达到 状态 signaled ，则会自动满足等待。 如果指定了显式超时值零，则如果无法立即满足等待，则不会等待。

返回值

等待完成状态。 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
Library ntdll.lib
DLL ntdll.dll