Функция NtWaitForSingleObject (winternl.h)

Статья
03/13/2024

Не рекомендуется. Ожидает, пока указанный объект не достигнет состояния signaled. NtWaitForSingleObject заменен на WaitForSingleObject.

Синтаксис

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

Параметры

[in] Handle

Дескриптор объекта wait.

[in] Alertable

Указывает, может ли быть доставлено оповещение при ожидании объекта.

TRUE

Оповещение может быть доставлено.

Ложь.

Не удается доставить оповещение.

[in] Timeout

Указатель на абсолютное или относительное время, в течение которого происходит ожидание. Может быть равен null. Если задано время ожидания и объект не достиг состояния по истечении signaled времени ожидания, то ожидание автоматически выполняется. Если указано явное значение времени ожидания, равное нулю, ожидание не происходит, если ожидание не может быть выполнено немедленно.

Возвращаемое значение

Состояние завершения ожидания. Различные значения NTSTATUS определяются в NTSTATUS. H, который распространяется с DDK Windows.

Код возврата	Описание
STATUS_SUCCESS	Указанный объект выполнил ожидание.
STATUS_TIMEOUT	Истекло время ожидания.
STATUS_ALERTED	Ожидание прервано, чтобы доставить оповещение в текущий поток.
STATUS_USER_APC	Ожидание прервано для доставки пользовательского асинхронного вызова процедур (APC) в текущий поток.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winternl.h
Библиотека	ntdll.lib
DLL	ntdll.dll

Поделиться через