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
NvBufferSize 中指定的长度不同。
STATUS_SUCCESS
请求已成功。

注解

在 Windows Server 的下一个主要版本之前,Windows Server 目前不支持此例程。

要求

要求
最低受支持的客户端 Windows 10 版本 1703
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 ntddk.h (包括 Winnt.h)

另请参阅

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlWriteNonVolatileMemory