共用方式為


NtWaitForSingleObject 函式 (winternl.h)

已取代。 等候指定的物件取得 的狀態 signaledNtWaitForSingleObject 已由 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 一起散發。

傳回碼 Description
STATUS_SUCCESS
指定的物件符合等候。
STATUS_TIMEOUT
發生逾時。
STATUS_ALERTED
等候已中止,以將警示傳遞給目前的線程。
STATUS_USER_APC
等候已中止,將 使用者異步過程呼叫 (APC) 傳遞至目前的線程。

備註

因為此函式沒有匯入連結庫,所以您必須使用 GetProcAddress

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winternl.h
程式庫 ntdll.lib
Dll ntdll.dll