Функция RtlRunOnceComplete (ntddk.h)

Статья
08/07/2023

Подпрограмма RtlRunOnceComplete завершает однократную инициализацию, начатую rtlRunOnceBeginInitialize.

Синтаксис

NTSYSAPI NTSTATUS RtlRunOnceComplete(
  [in, out]      PRTL_RUN_ONCE RunOnce,
  [in]           ULONG         Flags,
  [in, optional] PVOID         Context
);

Параметры

[in, out] RunOnce

Указатель на RTL_RUN_ONCE структуру одноразовой инициализации.

[in] Flags

При необходимости драйверы могут указывать один или несколько следующих флагов:

RTL_RUN_ONCE_ASYNC

Работа в асинхронном режиме. Этот режим позволяет выполнять несколько попыток завершения параллельно. Если используется этот флаг, последующие вызовы подпрограммы RtlRunOnceComplete завершатся ошибкой, если этот флаг также не указан.

RTL_RUN_ONCE_INIT_FAILED

Попытка инициализации завершилась сбоем.

[in, optional] Context

Указывает инициализированные данные.

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

RtlRunOnceComplete возвращает одно из следующих значений NTSTATUS:

Код возврата	Описание
STATUS_SUCCESS	Операция выполнена успешно.
STATUS_UNSUCCESSFUL	Не удалось завершить операцию. Если вызывающий объект, указанный RTL_RUN_ONCE_ASYNC в параметре Flags , это значение может указывать на то, что другой поток завершил инициализацию.

Если RtlRunOnceComplete возвращает STATUS_SUCCESS, любой последующий вызов RtlRunOnceBeginInginInitialize для той же структуры RTL_RUN_ONCE предоставляет контекст в качестве инициализированных данных.

Если вызывающий объект, указанный RTL_RUN_ONCE_ASYNC в параметре Flags , а RtlRunOnceComplete возвращает любое значение, отличное от STATUS_SUCCESS, вызывающий объект должен очистить все попытки инициализации.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	ntddk.h (включая Ntddk.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL