EnvelopedData.Encrypt-Methode

[CAPICOM ist eine nur 32-Bit-Komponente, die für die Verwendung 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 Encrypt-Methode generiert einen Sitzungsschlüssel, verwendet diesen Schlüssel zum Verschlüsseln des Inhalts, umhüllt den verschlüsselten Inhalt für jeden Empfänger, indem der Sitzungsschlüssel mit dem öffentlichen Schlüssel jedes Empfängers verschlüsselt wird, und gibt dann das BLOB zurück, das den verschlüsselten Inhalt und die verschlüsselten Sitzungsschlüssel als codierte Zeichenfolge enthält.

Syntax

EnvelopedData.Encrypt( _
  [ ByVal EncodingType ] _
)

Parameter

EncodingType [in, optional]

Ein Wert der CAPICOM_ENCODING_TYPE-Enumeration , der den Codierungstyp angibt, der zum Codieren der umhüllten Daten verwendet wird. Der Standardcodierungswert ist CAPICOM_ENCODE_BASE64. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
CAPICOM_ENCODE_ANY	Dieser Codierungstyp wird nur verwendet, wenn die Eingabedaten einen unbekannten Codierungstyp aufweisen. Wenn dieser Wert verwendet wird, um den Codierungstyp der Ausgabe anzugeben, wird stattdessen CAPICOM_ENCODE_BASE64 verwendet. In CAPICOM 2.0 eingeführt.
CAPICOM_ENCODE_BASE64	Daten werden als base64-codierte Zeichenfolge gespeichert.
CAPICOM_ENCODE_BINARY	Daten werden als reine Binärsequenz gespeichert.

 

Rückgabewert

Diese Methode gibt ein BLOB zurück, das die umhüllten Daten in einer codierten Zeichenfolge enthält.

Bemerkungen

Das zurückgegebene BLOB enthält den verschlüsselten Inhalt und einen verschlüsselten Sitzungsschlüssel für jeden beabsichtigten Empfänger. Diese Sitzungsschlüssel werden mit dem öffentlichen Schlüssel jedes Empfängers verschlüsselt. Die verschlüsselten Sitzungsschlüssel können nur mit dem privaten Schlüssel eines Empfängers entschlüsselt werden.

Wenn die Recipients-Eigenschaft keine Informationen enthält, durchsucht diese Methode den AddressBook-Zertifikatspeicher des aktuellen Benutzers nach potenziellen Empfängern. Wenn mehrere potenzielle Empfänger gefunden werden, wird der Benutzer aufgefordert, einen Empfänger aus einem Auswahldialogfeld auszuwählen.

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