NtWaitForSingleObject 函式 (winternl.h)
已取代。 等候指定的物件取得 的狀態 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 一起散發。
傳回碼 | Description |
---|---|
|
指定的物件符合等候。 |
|
發生逾時。 |
|
等候已中止,以將警示傳遞給目前的線程。 |
|
等候已中止,將 使用者異步過程呼叫 (APC) 傳遞至目前的線程。 |
備註
因為此函式沒有匯入連結庫,所以您必須使用 GetProcAddress。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winternl.h |
程式庫 | ntdll.lib |
Dll | ntdll.dll |