Función RtlGetNonVolatileToken (ntddk.h)

La rutina RtlGetNonVolatileToken obtiene varias propiedades sobre un búfer de memoria no volátil y las almacena en la variable NvToken.

Sintaxis

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

Parámetros

NvBuffer

Puntero a la memoria no volátil de la que va a realizar el seguimiento del estado de NvToken devuelto. Debe ser una dirección obtenida de un objeto de asignación de archivos.

Size

Longitud, en bytes, del búfer de memoria no volátil a la que apunta NvBuffer .

NvToken

Puntero a una estructura opaca que realiza un seguimiento de la información sobre la región de memoria no volátil especificada que RtlGetNonVolatileToken había devuelto.

Valor devuelto

La rutina RtlGetNonVolatileToken devuelve uno de los códigos de estado:

Código devuelto Descripción
STATUS_ACCESS_DENIED
El autor de la llamada tenía derechos de acceso insuficientes para realizar la acción solicitada.
STATUS_INFO_LENGTH_MISMATCH
La dirección base especificada está fuera del intervalo de direcciones accesibles.
STATUS_INVALID_PARAMETER
NvBuffer no es la misma longitud que se especifica enTamaño.
STATUS_SUCCESS
La solicitud fue correcta.

Comentarios

Esta rutina no se admite actualmente para Windows Server hasta la próxima versión principal de Windows Server.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1703
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado ntddk.h (incluye Winnt.h)

Consulte también

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlWriteNonVolatileMemory