Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
ProtectedData.Unprotect-Methode
Entschlüsselt die Daten in einem angegebenen Bytearray und gibt ein Bytearray zurück, das die entschlüsselten Daten enthält.
Assembly: System.Security (in System.Security.dll)
public static byte[] Unprotect( byte[] encryptedData, byte[] optionalEntropy, DataProtectionScope scope )
Parameter
- encryptedData
- Typ: System.Byte[]
Ein Bytearray, das Daten enthält, die mit der Protect-Methode verschlüsselt wurden.
- optionalEntropy
- Typ: System.Byte[]
Ein optionales zusätzliches Bytearray, das verwendet wurde, um die Daten zu verschlüsseln, oder null, wenn das zusätzliche Bytearray nicht verwendet wurde.
- scope
- Typ: System.Security.Cryptography.DataProtectionScope
Einer der Enumerationswerte, der den Bereich des Datenschutzes angibt, der verwendet wurde, um die Daten zu verschlüsseln.
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException |
Der encryptedData-Parameter ist null. |
| CryptographicException |
Die Entschlüsselung ist fehlgeschlagen. |
| NotSupportedException |
Dieses Methode wird vom Betriebssystem nicht unterstützt. |
| OutOfMemoryException |
Nicht genügend Arbeitsspeicher. |
Diese Methode kann verwendet werden, um den Schutz von Daten aufzuheben, die mit der Protect-Methode verschlüsselt wurden. Wenn bei der Verschlüsselung der optionalEntropy-Parameter verwendet wurde, muss er auch zur Entschlüsselung der Daten bereitgestellt werden.
Hinweis
|
|---|
|
Wenn Sie die Methode im Rahmen des Identitätswechsels verwenden, wird möglicherweise folgende Fehlermeldung angezeigt: "Ungültiger Schlüssel für angegebenen Status". Um diesen Fehler zu verhindern, laden Sie das Profil des Benutzers, den Sie imitieren möchten, bevor Sie die Methode aufrufen. |
Im folgenden Codebeispiel wird die Verwendung des Datenschutzes veranschaulicht.
using System; using System.Security.Cryptography; public class DataProtectionSample { // Create byte array for additional entropy when using Protect method. static byte [] s_aditionalEntropy = { 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_aditionalEntropy, 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_aditionalEntropy, 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(); } }
-
DataProtectionPermission
mit dem zugeordneten UnprotectData-Flag für die Berechtigung, den Schutz der Daten aufzuheben.
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Hinweis