Fonction RtlGetNonVolatileToken (ntddk.h)

La routine , RtlGetNonVolatileToken, obtient différentes propriétés sur une mémoire tampon 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 que NvBuffer pointe vers.

NvToken

Pointeur vers une structure opaque qui suit les informations sur la région de mémoire non volatile donnée que RtlGetNonVolatileToken avait retournée.

Valeur retournée

La routine RtlGetNonVolatileToken retourne l’un des codes status :

Code de retour Description
STATUS_ACCESS_DENIED
L’appelant ne disposait pas des droits d’accès suffisants pour effectuer l’action demandée.
STATUS_INFO_LENGTH_MISMATCH
L’adresse de base spécifiée se trouve en dehors de la plage des adresses accessibles.
STATUS_INVALID_PARAMETER
Le NvBuffer n’a pas la même longueur que celle spécifiée dansTaille.
STATUS_SUCCESS
La demande a abouti.

Remarques

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 version 1703
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête ntddk.h (inclure Winnt.h)

Voir aussi

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlWriteNonVolatileMemory