Partager via


RtlGetNonVolatileToken, fonction (ntddk.h)

La routine, RtlGetNonVolatileToken, obtient différentes propriétés sur une mémoire tampon de mémoire non volatile et les stocke dans la variable NvToken.

Syntaxe

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

Paramètres

NvBuffer

Pointeur vers la mémoire non volatile pour laquelle le NvToken retourné va suivre l’état. Il doit s’agir d’une adresse obtenue à partir d’un objet de mappage de fichiers.

Size

Longueur, en octets, de la mémoire tampon non volatile NvBuffer pointe vers.

NvToken

Pointeur vers une structure opaque qui suit les informations relatives à la région de mémoire non volatile donnée qui RtlGetNonVolatileToken a retourné.

Valeur de retour

La routine RtlGetNonVolatileToken retourne l’un des codes d’état :

Retourner le code Description
STATUS_ACCESS_DENIED
L’appelant avait des droits d’accès insuffisants pour effectuer l’action demandée.
STATUS_INFO_LENGTH_MISMATCH
L’adresse de base spécifiée se trouve en dehors de la plage d’adresses accessibles.
STATUS_INVALID_PARAMETER
La NvBuffer n’est pas la même longueur que celle spécifiée dansTaille.
STATUS_SUCCESS
La demande a réussi.

Remarques

Cette routine n’est actuellement pas prise en charge pour Windows Server jusqu’à la prochaine version majeure de Windows Server.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 1703
serveur minimum pris en charge Aucun pris en charge
plateforme cible Windows
d’en-tête ntddk.h (include Winnt.h)

Voir aussi

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlWriteNonVolatileMemory