ProtectedMemory.Protect(Byte[], MemoryProtectionScope) Метод

Ссылка

Определение

Пространство имен:: System.Security.Cryptography

Сборка:: System.Security.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Защищает заданные данные.

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)

Параметры

userData: Byte[]

Массив байтов, в котором содержатся данные, хранящиеся в оперативной памяти и подлежащие защите. Размер массива должен быть кратен 16 байтам.

scope: MemoryProtectionScope

Одно из значений перечисления, определяющее область действия защиты памяти.

Исключения

CryptographicException

Длина значения параметра userData должна быть равна или кратна 16 байтам.

NotSupportedException

Этот метод не поддерживается операционной системой. Этот метод может использоваться только в Windows 2000 или более поздних операционных системах Microsoft Windows.

ArgumentNullException

userData имеет значение null.

Примеры

В следующем примере кода показано, как использовать защиту данных.

#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

Этот метод можно использовать для защиты данных в памяти. Обратите внимание, что метод не делает копию данных, а шифрует массив байтов на месте. Параметр userData должен быть длиной 16 байт или кратным 16 байтам.

Поддержка этого метода доступна в операционных системах Windows XP и более поздних версий.

Применяется к

Поделиться через