ProtectedMemory.Protect(Byte[], MemoryProtectionScope) Metod

Definition

Namnområde:
System.Security.Cryptography
Sammansättning:
System.Security.dll

Skyddar angivna 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)

Parametrar

userData
Byte[]

Bytematrisen som innehåller data i minnet som ska skyddas. Matrisen måste vara en multipel av 16 byte.

scope
MemoryProtectionScope

Ett av uppräkningsvärdena som anger omfånget för minnesskydd.

Undantag

CryptographicException

userData måste vara 16 byte långa eller i multiplar på 16 byte.

NotSupportedException

Operativsystemet stöder inte den här metoden. Den här metoden kan endast användas med operativsystemen Windows 2000 eller senare.

ArgumentNullException

userData är null.

Exempel

I följande kodexempel visas hur du använder dataskydd.

#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

Kommentarer

Den här metoden kan användas för att skydda data i minnet. Observera att metoden inte gör en kopia av data, utan krypterar bytematrisen på plats. Parametern userData måste vara 16 byte lång eller en multipel av 16 byte.

Stöd för den här metoden finns i Windows XP och senare operativsystem.

Gäller för