Compartilhar via


Função RtlEncryptMemory (ntsecapi.h)

[A função RtlDecryptMemory está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use a função CryptProtectMemory .]

A função RtlEncryptMemory criptografa o conteúdo da memória. O conteúdo criptografado pode ser descriptografado por uma chamada subsequente para a função RtlDecryptMemory .

Nota Essa função não tem biblioteca de importação associada. Essa função está disponível como um recurso chamado SystemFunction040 no Advapi32.dll. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Advapi32.dll.
 

Sintaxe

NTSTATUS RtlEncryptMemory(
  [in, out] PVOID Memory,
  [in]      ULONG MemorySize,
  [in]      ULONG OptionFlags
);

Parâmetros

[in, out] Memory

Um ponteiro para a memória a ser criptografada. O tamanho da memória deve ser um múltiplo da constante RTL_ENCRYPT_MEMORY_SIZE.

[in] MemorySize

Número de bytes aos quais a Memória aponta. O número de bytes deve ser um múltiplo da constante RTL_ENCRYPT_MEMORY_SIZE.

[in] OptionFlags

Valor que especifica como a criptografia funciona sobre limites de processo e representação. Esse parâmetro pode usar um dos valores a seguir. Os valores são mutuamente exclusivos. Você deve especificar o mesmo sinalizador ao criptografar e descriptografar a memória.

Valor Significado
0
Criptografar e descriptografar a memória no mesmo processo. Um aplicativo em execução em um processo diferente não poderá descriptografar os dados.
RTL_ENCRYPT_OPTION_CROSS_PROCESS
Criptografar e descriptografar a memória em processos diferentes. Um aplicativo em execução em um processo diferente poderá descriptografar os dados.
RTL_ENCRYPT_OPTION_SAME_LOGON
Use as mesmas credenciais de logon para criptografar e descriptografar a memória em processos diferentes. Um aplicativo em execução em um processo diferente poderá descriptografar os dados. No entanto, o processo deve ser executado como o mesmo usuário que criptografou os dados e na mesma sessão de logon.

Retornar valor

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um código NTSTATUS que indica o erro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003, Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecapi.h
DLL Advapi32.dll