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 se devuelve nvToken va a realizar un seguimiento del estado. Debe ser una dirección obtenida de un objeto de asignación de archivos.

Size

La longitud, en bytes, del búfer de memoria no volátil nvBuffer apunta.

NvToken

Puntero a una estructura opaca que realiza un seguimiento de la información sobre la región de memoria no volátil dada que rtlGetNonVolatileToken.

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 no tenía derechos de acceso suficientes 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	El nvBuffer no es la misma longitud que se especifica enSize.
STATUS_SUCCESS	La solicitud se realizó correctamente.

Observaciones

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

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10, versión 1703
servidor mínimo admitido	No se admite ninguna
de la plataforma de destino de	Windows
encabezado de	ntddk.h (incluya Winnt.h)

Consulte también

rtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

rtlWriteNonVolatileMemory