Compartilhar via

Função RtlDecryptMemory (ntsecapi.h)

  • Artigo

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

A função RtlDecryptMemory descriptografa conteúdo de memória criptografado anteriormente pela função rtlEncryptMemory .

Nota

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

Sintaxe

NTSTATUS RtlDecryptMemory(
  [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 pontos de memória. 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 ser 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 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
0x01		 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
0x02		 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.
RTL_ENCRYPT_OPTION_FOR_SYSTEM
0x04		 Permitir que os chamadores criptografem informações a serem descriptografadas apenas por um processo do sistema.

Valor de retorno

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
de cliente com suporte mínimo Windows XP, Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003, Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho ntsecapi.h
de DLL Advapi32.dll