EnvelopedData.Decrypt-Methode

[CAPICOM ist eine 32-Bit-Komponente, die in den folgenden Betriebssystemen verfügbar ist: Windows Server 2008, Windows Vista und Windows XP. Verwenden Sie stattdessen die EnvelopedCms-Klasse im System.Security.Cryptography.Pkcs-Namespace .]

Die Decrypt-Methode entschlüsselt umhüllte Inhalte. Die Entschlüsselung erfolgt, wenn der Empfänger der Nachricht Zugriff auf den privaten Schlüssel hat, der mit einem der öffentlichen Schlüssel gekoppelt ist, der zum Einhüllen der Nachricht verwendet wird. Durch Aufrufen der Decrypt-Methode wird der Zustand des Objekts zurückgesetzt. Wenn die Decrypt-Methode erfolgreich ist, wird die Content-Eigenschaft des EnvelopedData-Objekts auf die Nur-Text-Nachricht festgelegt.

Syntax

EnvelopedData.Decrypt( _
  ByVal EnvelopedMessage _
)

Parameter

EnvelopedMessage [in]

Zeichenfolge, die die umhüllten Daten enthält, die entschlüsselt werden sollen.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Die entschlüsselten Daten werden zum Content-Eigenschaftswert für das EnvelopedData-Objekt .

Wenn der Benutzer dieser Methode keinen Zugriff auf einen privaten Schlüssel hat, der mit einem der öffentlichen Schlüssel übereinstimmt, die zum Einhüllen der Nachricht verwendet wurden, schlägt die Methode fehl. Diese Methode schlägt fehl, wenn sich das Zertifikat für den zugeordneten privaten Schlüssel weder im MY-Speicher des lokalen Computers noch im aktuellen MY-Speicher des Benutzers befindet.

Wichtig

Wenn diese Methode aus einem Webskript aufgerufen wird, muss das Skript Ihren privaten Schlüssel verwenden, um die Daten zu entschlüsseln. Das Zulassen, dass nicht vertrauenswürdige Websites Ihren privaten Schlüssel verwenden, ist ein Sicherheitsrisiko. Ein Dialogfeld, in dem gefragt wird, ob die Website Ihren privaten Schlüssel verwenden kann, wird angezeigt, wenn diese Methode zum ersten Mal aufgerufen wird. Wenn Sie zulassen, dass das Skript Ihren privaten Schlüssel verwendet und "Nicht erneut fragen" auswählen, wird das Dialogfeld für kein Skript mehr angezeigt, das Ihren privaten Schlüssel zum Entschlüsseln von Daten innerhalb dieser Domäne verwendet. Skripts außerhalb dieser Domäne, die versuchen, Ihren privaten Schlüssel zum Entschlüsseln von Daten zu verwenden, führen jedoch dazu, dass dieses Dialogfeld weiterhin angezeigt wird. Wenn Sie nicht zulassen, dass das Skript Ihren privaten Schlüssel verwendet und "Nicht erneut fragen" auswählen, wird Skripts innerhalb dieser Domäne automatisch die Möglichkeit verweigert, Ihren privaten Schlüssel zum Entschlüsseln von Daten zu verwenden.

 

Anforderungen

Anforderung	Wert
Ende des Supports (Client)	Windows Vista
Ende des Supports (Server)	WindowsServer 2008
Verteilbare Komponente	CAPICOM 2.0 oder höher unter Windows Server 2003 und Windows XP
DLL	Capicom.dll

Siehe auch

Kryptografieobjekte

EnvelopedData