Função RtlGetNonVolatileToken (ntddk.h)

A rotina, RtlGetNonVolatileToken, obtém várias propriedades sobre um buffer de memória não volátil e as armazena na variável NvToken.

Sintaxe

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

Parâmetros

NvBuffer

Um ponteiro para a memória não volátil para a qual o NvToken retornado rastreará o estado. Esse deve ser um endereço obtido de um objeto de mapeamento de arquivo.

Size

O comprimento, em bytes, do buffer de memória não volátil para o qual nvBuffer aponta.

NvToken

Um ponteiro para uma estrutura opaca que rastreia informações sobre a região de memória não volátil fornecida que RtlGetNonVolatileToken havia retornado.

Retornar valor

A rotina RtlGetNonVolatileToken retorna um dos códigos de status:

Código de retorno Descrição
STATUS_ACCESS_DENIED
O chamador não tinha direitos de acesso suficientes para executar a ação solicitada.
STATUS_INFO_LENGTH_MISMATCH
O endereço base especificado está fora do intervalo de endereços acessíveis.
STATUS_INVALID_PARAMETER
O NvBuffer não tem o mesmo comprimento especificado emTamanho.
STATUS_SUCCESS
A solicitação foi bem-sucedida.

Comentários

Atualmente, essa rotina não tem suporte para o Windows Server até a próxima versão principal do Windows Server.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1703
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho ntddk.h (inclua Winnt.h)

Confira também

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

RtlFreeNonVolatileToken

RtlWriteNonVolatileMemory