ProtectedMemory.Protect(Byte[], MemoryProtectionScope) Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography

Zestaw:

System.Security.dll

Chroni określone dane.

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)

Parametry

userData

Byte[]

Tablica bajtów zawierająca dane w pamięci do ochrony. Tablica musi mieć wielokrotność 16 bajtów.

scope

MemoryProtectionScope

Jedna z wartości wyliczenia, która określa zakres ochrony pamięci.

Wyjątki

CryptographicException

userData musi mieć długość 16 bajtów lub wielokrotność 16 bajtów.

NotSupportedException

System operacyjny nie obsługuje tej metody. Tej metody można używać tylko w systemach operacyjnych Windows 2000 lub nowszych.

ArgumentNullException

userData to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ochrony danych.

#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

Uwagi

Ta metoda może służyć do ochrony danych w pamięci. Należy pamiętać, że metoda nie wykonuje kopii danych, ale szyfruje tablicę bajtów. Parametr userData musi mieć długość 16 bajtów lub wielokrotność 16 bajtów.

Obsługa tej metody jest dostępna w systemach operacyjnych Windows XP i nowszych.