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

  • Статья

Подпрограмма RtlGetNonVolatileToken получает различные свойства буфера энергонезависимой памяти и сохраняет их в переменной NvToken.

Синтаксис

NTSYSAPI NTSTATUS RtlGetNonVolatileToken(
  PVOID  NvBuffer,
  SIZE_T Size,
  PVOID  *NvToken
);

Параметры

NvBuffer

Указатель на энергонезависимую память, состояние для которую будет отслеживать возвращенный NvToken . Это должен быть адрес, полученный из объекта сопоставления файлов.

Size

Длина в байтах буфера энергонезависимой памяти NvBuffer указывает на .

NvToken

Указатель на непрозрачную структуру, которая отслеживает сведения о заданной области энергонезависимой памяти, возвращенной RtlGetNonVolatileToken .

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

Подпрограмма RtlGetNonVolatileToken возвращает один из кодов состояния:

Код возврата Описание
STATUS_ACCESS_DENIED
 У вызывающего объекта недостаточно прав доступа для выполнения запрошенного действия.
STATUS_INFO_LENGTH_MISMATCH
Указанный базовый адрес выходит за пределы диапазона доступных адресов.
STATUS_INVALID_PARAMETER
 Длина NvBuffer отличается от длины, указанной вразделе Размер.
STATUS_SUCCESS
 Запрос выполнен успешно.

Комментарии

Эта подпрограмма в настоящее время не поддерживается для Windows Server до следующего основного выпуска Windows Server.

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1703
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header ntddk.h (включая Winnt.h)

См. также раздел

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlWriteNonVolatileMemory