ProtectedMemory.Protect(Byte[], MemoryProtectionScope) Méthode

Définition

Espace de noms:

System.Security.Cryptography

Assembly:

System.Security.dll

Protège les données spécifiées.

public:
 static void Protect(cli::array <System::Byte> ^ userData, System::Security::Cryptography::MemoryProtectionScope scope);

public static void Protect (byte[] userData, System.Security.Cryptography.MemoryProtectionScope scope);

static member Protect : byte[] * System.Security.Cryptography.MemoryProtectionScope -> unit

Public Shared Sub Protect (userData As Byte(), scope As MemoryProtectionScope)

Paramètres

userData

Byte[]

Le tableau d'octets qui contient les données en mémoire à protéger. Le tableau doit être un multiple de 16 octets.

scope

MemoryProtectionScope

Une des valeurs d'énumération qui spécifie la portée de la protection de la mémoire.

Exceptions

CryptographicException

userData doit avoir une longueur de 16 octets ou d'un multiple de 16 octets.

NotSupportedException

Le système d'exploitation ne prend pas en charge cette méthode. Cette méthode peut être utilisée uniquement avec le système d'exploitation Windows 2000 ou version ultérieure

ArgumentNullException

userData a la valeur null.

Exemples

L’exemple de code suivant montre comment utiliser la protection des données.

#using <System.Security.dll>

using namespace System;
using namespace System::Security::Cryptography;

int main()
{
   
   // Create the original data to be encrypted (The data length should be a multiple of 16).
   array<Byte>^secret = {1,2,3,4,1,2,3,4,1,2,3,4,1,2,3,4};
   
   // Encrypt the data in memory. The result is stored in the same array as the original data.
   ProtectedMemory::Protect( secret, MemoryProtectionScope::SameLogon );
   
   // Decrypt the data in memory and store in the original array.
   ProtectedMemory::Unprotect( secret, MemoryProtectionScope::SameLogon );
}

using System;
using System.Security.Cryptography;

public class MemoryProtectionSample
{

    public static void Main()
    {
        // Create the original data to be encrypted (The data length should be a multiple of 16).
        byte [] secret = { 1, 2, 3, 4, 1, 2, 3, 4, 1, 2, 3, 4, 1, 2, 3, 4 };

        // Encrypt the data in memory. The result is stored in the same array as the original data.
        ProtectedMemory.Protect( secret, MemoryProtectionScope.SameLogon );

        // Decrypt the data in memory and store in the original array.
        ProtectedMemory.Unprotect( secret, MemoryProtectionScope.SameLogon );
    }
}

Imports System.Security.Cryptography

Public Class MemoryProtectionSample

    Public Shared Sub Main()
        ' Create the original data to be encrypted (The data length should be a multiple of 16).
        Dim secret As Byte() = {1, 2, 3, 4, 1, 2, 3, 4, 1, 2, 3, 4, 1, 2, 3, 4}

        ' Encrypt the data in memory. The result is stored in the same array as the original data.
        ProtectedMemory.Protect(secret, MemoryProtectionScope.SameLogon)

        ' Decrypt the data in memory and store in the original array.
        ProtectedMemory.Unprotect(secret, MemoryProtectionScope.SameLogon)

    End Sub
End Class

Remarques

Cette méthode peut être utilisée pour protéger les données en mémoire. Notez que la méthode ne fait pas une copie des données, mais chiffre le tableau d’octets en place. Le userData paramètre doit avoir une longueur de 16 octets ou un multiple de 16 octets.

La prise en charge de cette méthode est disponible dans les systèmes d’exploitation Windows XP et ultérieurs.