ProtectedMemory.Protect(Byte[], MemoryProtectionScope) Metoda

Reference

Definice

Obor názvů:: System.Security.Cryptography

Sestavení:: System.Security.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Chrání zadaná data.

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[]

Bajtové pole obsahující data v paměti k ochraně. Pole musí být násobek 16 bajtů.

scope: MemoryProtectionScope

Jedna z hodnot výčtu, která určuje rozsah ochrany paměti.

Výjimky

CryptographicException

userData musí mít délku 16 bajtů nebo násobky 16 bajtů.

NotSupportedException

Operační systém tuto metodu nepodporuje. Tuto metodu lze použít pouze s operačním systémem Windows 2000 nebo novějším.

ArgumentNullException

userData je null.

Příklady

Následující příklad kódu ukazuje, jak používat ochranu dat.

#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

Poznámky

Tuto metodu lze použít k ochraně dat v paměti. Všimněte si, že metoda nevytáčí kopii dat, ale zašifruje pole bajtů na místě. Parametr userData musí mít délku 16 bajtů nebo násobek 16 bajtů.

Podpora této metody je k dispozici v systému Windows XP a novějších operačních systémech.

Platí pro

Sdílet prostřednictvím