Freigeben über

RtlDecryptMemory-Funktion (ntsecapi.h)

  • Artikel

[Die RtlDecryptMemory Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die CryptUnprotectMemory Funktion.]

Die RtlDecryptMemory Funktion entschlüsselt speicherinhalte, die zuvor durch die RtlEncryptMemory Funktion verschlüsselt wurden.

Anmerkung

 Diese Funktion weist keine zugeordnete Importbibliothek auf. Diese Funktion ist als Ressource mit dem Namen SystemFunction041 in Advapi32.dllverfügbar. Sie müssen die LoadLibrary und GetProcAddress Funktionen verwenden, um dynamisch mit Advapi32.dllzu verknüpfen.

Syntax

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

Parameter

[in, out] Memory

Ein Zeiger auf den zu verschlüsselnden Speicher. Die Größe des Speichers muss ein Vielfaches der RTL_ENCRYPT_MEMORY_SIZE Konstante sein.

[in] MemorySize

Anzahl der Bytes, auf die Speicher Punkt gesetzt werden. Die Anzahl der Bytes muss ein Vielfaches der RTL_ENCRYPT_MEMORY_SIZE Konstante sein.

[in] OptionFlags

Wert, der angibt, wie die Verschlüsselung über Prozessgrenzen und Identitätswechsel funktioniert. Dieser Parameter kann einer der folgenden Werte sein: Die Werte schließen sich gegenseitig aus. Sie müssen beim Verschlüsseln und Entschlüsseln des Speichers das gleiche Kennzeichen angeben.

Wert Bedeutung
0 Verschlüsseln und Entschlüsseln des Speichers im selben Prozess. Eine Anwendung, die in einem anderen Prozess ausgeführt wird, kann die Daten nicht entschlüsseln.
RTL_ENCRYPT_OPTION_CROSS_PROCESS
0x01		 Verschlüsseln und Entschlüsseln des Speichers in verschiedenen Prozessen. Eine Anwendung, die in einem anderen Prozess ausgeführt wird, kann die Daten entschlüsseln.
RTL_ENCRYPT_OPTION_SAME_LOGON
0x02		 Verwenden Sie die gleichen Anmeldeinformationen, um Speicher in verschiedenen Prozessen zu verschlüsseln und zu entschlüsseln. Eine Anwendung, die in einem anderen Prozess ausgeführt wird, kann die Daten entschlüsseln. Der Prozess muss jedoch wie derselbe Benutzer ausgeführt werden, der die Daten verschlüsselt hat und sich in derselben Anmeldesitzung befindet.
RTL_ENCRYPT_OPTION_FOR_SYSTEM
0x04		 Zulassen, dass Aufrufer Informationen verschlüsseln, die nur von einem Systemprozess entschlüsselt werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert STATUS_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein NTSTATUS- Code, der den Fehler angibt.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows XP, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003, Windows Server 2003 [nur Desktop-Apps]
Zielplattform- Fenster
Header- ntsecapi.h
DLL- Advapi32.dll