ProtectedData.Unprotect Método

Definição

Espaço de Nomes:: System.Security.Cryptography

Assemblagem:: System.Security.Cryptography.ProtectedData.dll

Assemblagem:: System.Security.dll

Pacote:: System.Security.Cryptography.ProtectedData v11.0.0-preview.4.26230.115

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

Name	Description
Unprotect(Byte[], Byte[], DataProtectionScope)	Descifra os dados num array de bytes especificado e devolve um array de bytes que contém os dados desencriptados.
Unprotect(ReadOnlySpan<Byte>, DataProtectionScope, ReadOnlySpan<Byte>)	Descifra os dados num array de bytes especificado e devolve um array de bytes que contém os dados desencriptados.
Unprotect(ReadOnlySpan<Byte>, DataProtectionScope, Span<Byte>, ReadOnlySpan<Byte>)	Descifra os dados num buffer especificado e escreve os dados desencriptados num buffer de destino.

Unprotect(Byte[], Byte[], DataProtectionScope)

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Descifra os dados num array de bytes especificado e devolve um array de bytes que contém os dados desencriptados.

public:
 static cli::array <System::Byte> ^ Unprotect(cli::array <System::Byte> ^ encryptedData, cli::array <System::Byte> ^ optionalEntropy, System::Security::Cryptography::DataProtectionScope scope);

public static byte[] Unprotect(byte[] encryptedData, byte[]? optionalEntropy, System.Security.Cryptography.DataProtectionScope scope);

public static byte[] Unprotect(byte[] encryptedData, byte[] optionalEntropy, System.Security.Cryptography.DataProtectionScope scope);

static member Unprotect : byte[] * byte[] * System.Security.Cryptography.DataProtectionScope -> byte[]

Public Shared Function Unprotect (encryptedData As Byte(), optionalEntropy As Byte(), scope As DataProtectionScope) As Byte()

Parâmetros

encryptedData: Byte[]

Um array de bytes contendo dados encriptados usando o Protect(Byte[], Byte[], DataProtectionScope) método.

optionalEntropy: Byte[]

Um array opcional de bytes adicionais que era usado para encriptar os dados, ou null se o array de bytes adicionais não fosse utilizado.

scope: DataProtectionScope

Um dos valores de enumeração que especifica o âmbito da proteção de dados usado para encriptar os dados.

Devoluções

Byte[]

Um array de bytes que representa os dados desencriptados.

Exceções

ArgumentNullException

O encryptedData parâmetro é null.

CryptographicException

A desencriptação falhou.

NotSupportedException

O sistema operativo não suporta este método.

OutOfMemoryException

Sem memória.

PlatformNotSupportedException

.NET Core e .NET 5+ apenas: Chamadas ao método Unprotect são suportadas apenas em sistemas operativos Windows.

Exemplos

O seguinte exemplo de código mostra como usar a proteção de dados.

using System;
using System.Security.Cryptography;

public class DataProtectionSample
{
    // Create byte array for additional entropy when using Protect method.
    static byte [] s_additionalEntropy = { 9, 8, 7, 6, 5 };

    public static void Main()
    {
        // Create a simple byte array containing data to be encrypted.
        byte [] secret = { 0, 1, 2, 3, 4, 1, 2, 3, 4 };

        //Encrypt the data.
        byte [] encryptedSecret = Protect( secret );
        Console.WriteLine("The encrypted byte array is:");
        PrintValues(encryptedSecret);

        // Decrypt the data and store in a byte array.
        byte [] originalData = Unprotect( encryptedSecret );
        Console.WriteLine("{0}The original data is:", Environment.NewLine);
        PrintValues(originalData);
    }

    public static byte [] Protect( byte [] data )
    {
        try
        {
            // Encrypt the data using DataProtectionScope.CurrentUser. The result can be decrypted
            // only by the same current user.
            return ProtectedData.Protect( data, s_additionalEntropy, DataProtectionScope.CurrentUser );
        }
        catch (CryptographicException e)
        {
            Console.WriteLine("Data was not encrypted. An error occurred.");
            Console.WriteLine(e.ToString());
            return null;
        }
    }

    public static byte [] Unprotect( byte [] data )
    {
        try
        {
            //Decrypt the data using DataProtectionScope.CurrentUser.
            return ProtectedData.Unprotect( data, s_additionalEntropy, DataProtectionScope.CurrentUser );
        }
        catch (CryptographicException e)
        {
            Console.WriteLine("Data was not decrypted. An error occurred.");
            Console.WriteLine(e.ToString());
            return null;
        }
    }

    public static void PrintValues( Byte[] myArr )
    {
        foreach ( Byte i in myArr )
        {
            Console.Write( "\t{0}", i );
        }
        Console.WriteLine();
    }
}

Imports System.Security.Cryptography



Public Class DataProtectionSample
    ' Create byte array for additional entropy when using Protect method.
    Private Shared s_additionalEntropy As Byte() = {9, 8, 7, 6, 5}


    Public Shared Sub Main()
        ' Create a simple byte array containing data to be encrypted.
        Dim secret As Byte() = {0, 1, 2, 3, 4, 1, 2, 3, 4}

        'Encrypt the data.
        Dim encryptedSecret As Byte() = Protect(secret)
        Console.WriteLine("The encrypted byte array is:")
        PrintValues(encryptedSecret)

        ' Decrypt the data and store in a byte array.
        Dim originalData As Byte() = Unprotect(encryptedSecret)
        Console.WriteLine("{0}The original data is:", Environment.NewLine)
        PrintValues(originalData)

    End Sub


    Public Shared Function Protect(ByVal data() As Byte) As Byte()
        Try
            ' Encrypt the data using DataProtectionScope.CurrentUser. The result can be decrypted
            '  only by the same current user.
            Return ProtectedData.Protect(data, s_additionalEntropy, DataProtectionScope.CurrentUser)
        Catch e As CryptographicException
            Console.WriteLine("Data was not encrypted. An error occurred.")
            Console.WriteLine(e.ToString())
            Return Nothing
        End Try

    End Function


    Public Shared Function Unprotect(ByVal data() As Byte) As Byte()
        Try
            'Decrypt the data using DataProtectionScope.CurrentUser.
            Return ProtectedData.Unprotect(data, s_additionalEntropy, DataProtectionScope.CurrentUser)
        Catch e As CryptographicException
            Console.WriteLine("Data was not decrypted. An error occurred.")
            Console.WriteLine(e.ToString())
            Return Nothing
        End Try

    End Function


    Public Shared Sub PrintValues(ByVal myArr() As [Byte])
        Dim i As [Byte]
        For Each i In myArr
            Console.Write(vbTab + "{0}", i)
        Next i
        Console.WriteLine()

    End Sub
End Class

Observações

Este método pode ser usado para desproteger dados que foram encriptados usando o método Protect . Se o optionalEntropy parâmetro foi usado durante a encriptação, deve ser fornecido para desencriptar os dados.

Note

Se usar este método durante a personificação, pode receber o seguinte erro: "Chave não válida para uso no estado especificado." Para evitar este erro, carregue o perfil do utilizador que pretende imitar antes de chamar o método.

Aplica-se a

Unprotect(ReadOnlySpan<Byte>, DataProtectionScope, ReadOnlySpan<Byte>)

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Descifra os dados num array de bytes especificado e devolve um array de bytes que contém os dados desencriptados.

public static byte[] Unprotect(ReadOnlySpan<byte> encryptedData, System.Security.Cryptography.DataProtectionScope scope, ReadOnlySpan<byte> optionalEntropy = default);

static member Unprotect : ReadOnlySpan<byte> * System.Security.Cryptography.DataProtectionScope * ReadOnlySpan<byte> -> byte[]

Public Shared Function Unprotect (encryptedData As ReadOnlySpan(Of Byte), scope As DataProtectionScope, Optional optionalEntropy As ReadOnlySpan(Of Byte) = Nothing) As Byte()

Parâmetros

encryptedData: ReadOnlySpan<Byte>

Um buffer que contém dados para desencriptar.

scope: DataProtectionScope

Um dos valores de enumeração que especifica o âmbito da encriptação.

optionalEntropy: ReadOnlySpan<Byte>

Um buffer adicional opcional usado para aumentar a complexidade da encriptação, ou vazio sem complexidade adicional.

Devoluções

Byte[]

Um array de bytes que representa os dados encriptados.

Exceções

CryptographicException

A encriptação falhou.

NotSupportedException

O sistema operativo não suporta este método.

OutOfMemoryException

O sistema ficou sem memória durante a desencriptação dos dados.

PlatformNotSupportedException

O sistema operativo não é o Windows.

Aplica-se a

Unprotect(ReadOnlySpan<Byte>, DataProtectionScope, Span<Byte>, ReadOnlySpan<Byte>)

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Origem:: ProtectedData.cs

Descifra os dados num buffer especificado e escreve os dados desencriptados num buffer de destino.

public static int Unprotect(ReadOnlySpan<byte> encryptedData, System.Security.Cryptography.DataProtectionScope scope, Span<byte> destination, ReadOnlySpan<byte> optionalEntropy = default);

static member Unprotect : ReadOnlySpan<byte> * System.Security.Cryptography.DataProtectionScope * Span<byte> * ReadOnlySpan<byte> -> int

Public Shared Function Unprotect (encryptedData As ReadOnlySpan(Of Byte), scope As DataProtectionScope, destination As Span(Of Byte), Optional optionalEntropy As ReadOnlySpan(Of Byte) = Nothing) As Integer

Parâmetros

encryptedData: ReadOnlySpan<Byte>

Um buffer que contém dados para desencriptar.

scope: DataProtectionScope

Um dos valores de enumeração que especifica o âmbito da encriptação.

destination: Span<Byte>

O buffer para receber os dados desencriptados.

optionalEntropy: ReadOnlySpan<Byte>

Um buffer adicional opcional usado para aumentar a complexidade da encriptação, ou vazio sem complexidade adicional.

Devoluções

Int32

O número total de bytes escritos em destination

Exceções

ArgumentException

O buffer é destination demasiado pequeno para armazenar os dados desencriptados.

CryptographicException

A encriptação falhou.

NotSupportedException

O sistema operativo não suporta este método.

OutOfMemoryException

O sistema ficou sem memória durante a encriptação dos dados.

PlatformNotSupportedException

O sistema operativo não é o Windows.

Aplica-se a

Comentários

Esta página foi útil?