Partager via

Fonction RtlEncryptMemory (ntsecapi.h)

  • Article

[La fonction RtlDecryptMemory est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt la fonction CryptProtectMemory.]

La fonction RtlEncryptMemory chiffre le contenu de la mémoire. Le contenu chiffré peut être déchiffré par un appel ultérieur à la fonction RtlDecryptMemory.

Note

 Cette fonction n’a aucune bibliothèque d’importation associée. Cette fonction est disponible sous la forme d’une ressource nommée SystemFunction040 dans Advapi32.dll. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir un lien dynamique vers Advapi32.dll.

Syntaxe

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

Paramètres

[in, out] Memory

Pointeur vers la mémoire à chiffrer. La taille de la mémoire doit être un multiple de la constante RTL_ENCRYPT_MEMORY_SIZE.

[in] MemorySize

Nombre d’octets auxquels points de mémoire. Le nombre d’octets doit être un multiple de la constante RTL_ENCRYPT_MEMORY_SIZE.

[in] OptionFlags

Valeur qui spécifie le fonctionnement du chiffrement sur les limites de processus et l’emprunt d’identité. Ce paramètre peut être l’une des valeurs suivantes. Les valeurs s’excluent mutuellement. Vous devez spécifier le même indicateur lors du chiffrement et du déchiffrement de la mémoire.

Valeur Signification
0 Chiffrer et déchiffrer la mémoire dans le même processus. Une application s’exécutant dans un autre processus ne pourra pas déchiffrer les données.
RTL_ENCRYPT_OPTION_CROSS_PROCESS
0x01		 Chiffrer et déchiffrer la mémoire dans différents processus. Une application s’exécutant dans un autre processus sera en mesure de déchiffrer les données.
RTL_ENCRYPT_OPTION_SAME_LOGON
0x02		 Utilisez les mêmes informations d’identification d’ouverture de session pour chiffrer et déchiffrer la mémoire dans différents processus. Une application s’exécutant dans un autre processus sera en mesure de déchiffrer les données. Toutefois, le processus doit s’exécuter en tant qu’utilisateur qui a chiffré les données et dans la même session d’ouverture de session.
RTL_ENCRYPT_OPTION_FOR_SYSTEM
0x04		 Autoriser les appelants à chiffrer les informations à déchiffrer uniquement par un processus système.

Valeur de retour

Si la fonction réussit, la valeur de retour est STATUS_SUCCESS.

Si la fonction échoue, la valeur de retour est une NTSTATUS code qui indique l’erreur.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003, Windows Server 2003 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête ntsecapi.h
DLL Advapi32.dll