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 acompanhará 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 NvBuffer aponta para.

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.

Valor de retorno

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 emSize.
STATUS_SUCCESS	A solicitação foi bem-sucedida.

Observações

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1703
servidor com suporte mínimo	Nenhum com suporte
da Plataforma de Destino	Windows
cabeçalho	ntddk.h (inclua Winnt.h)

Consulte também

RtlDrainNonVolatileFlush

RtlFlushNonVolatileMemory

RtlFlushNonVolatileMemoryRanges

rtlFreeNonVolatileToken

rtlWriteNonVolatileMemory